Playoffs
This guide will walk you through fetching playoff schedules, including how to access games as they become available, analyzing matchup behavior, and constructing a playoff bracket.
Introduction to Playoffs
The NCAA football (NCAAFB) postseason includes two primary formats: the College Football Playoff (CFP) and the FCS Playoffs. The CFP is a 12-team, single-elimination tournament that determines the national champion among the top teams in the Football Bowl Subdivision (FBS). Meanwhile, the FCS Playoffs are a larger 24-team tournament, also single-elimination, that crowns the champion of the Football Championship Subdivision (FCS). Both formats conclude with a championship game that determines the top team in their respective divisions.
You can access playoff data using these feeds:
- The Tournament List endpoint provides a summarized list of all tournaments scheduled for the given season.
- The Tournament Schedule endpoint provides the date, time, location, and other event details for every matchup taking place in a given tournament.
- Lastly, the Tournament Summary endpoint provides tournament information including location, status, start date, end date, and participants.
New Tournament Feeds!
Note: These tournament feeds are newly added to the NCAAFB API, so tournament data may not be available for seasons prior to the 2024 release of these enhancements.
Prerequisite - Accessing Available Seasons
To avoid confusion and ensure you're accessing available data, refer to our Seasons feed. This resource lists all the seasons for which we have data.
For example: To ensure data availability for future seasons, such as a schedule in advance of when a season begins, first check the Seasons feed to verify that data for that specific season is already provided.
Starting with this feed can prevent unnecessary errors and streamline your data retrieval process.
Building Your Playoff Bracket
1. Access the Post Season Tournament List
Call the Tournament List endpoint to get the list of available tournaments and tournament ids for the season.
The following samples shows a list of tournaments for the 2024 NCAAFB Post-Season.
{
"league": {
"id": "26c1246a-2fc3-4b7e-8999-1685d3ab4676",
"name": "NCAA Football",
"alias": "NCAAFB"
},
"season": {
"id": "908fbc20-f5c7-11ee-a306-c311afc28263",
"year": 2024,
"type": "REG"
},
"tournaments": [
{
"id": "6f76ebc2-e6b1-4e0a-8898-ae4bf313563c",
"name": "FCS Playoffs",
"location": "Frisco, TX, USA",
"status": "scheduled",
"start_date": "2024-11-30",
"end_date": "2025-01-06"
},
{
"id": "77b49a1b-e3a0-4833-9ab0-799367dd97b1",
"name": "College Football Playoff",
"location": "Atlanta, GA, USA",
"status": "scheduled",
"start_date": "2024-12-20",
"end_date": "2025-01-20"
}
]
}
2. Pull the Tournament Schedule
Using the tournament id, pull the Tournament Schedule endpoint to get the date, time and location for each matchup in the tournament.
{
"id": "77b49a1b-e3a0-4833-9ab0-799367dd97b1",
"name": "College Football Playoff",
"location": "Atlanta, GA, USA",
"status": "scheduled",
"league": {
"id": "26c1246a-2fc3-4b7e-8999-1685d3ab4676",
"name": "NCAA Football",
"alias": "NCAAFB"
},
"season": {
"id": "908fbc20-f5c7-11ee-a306-c311afc28263",
"year": 2024,
"type": "REG"
},
"rounds": [
{
"id": "9d9f0022-5125-40b0-a5c0-5e97b3d122c5",
"sequence": 1,
"name": "First Round",
"games": [
{
"id": "d3dab414-6d89-4b40-90a4-288223c699f2",
"title": "College Football Playoff - First Round",
"status": "scheduled",
"coverage": "full",
"game_type": "playoff",
"scheduled": "2024-12-21T17:00:00+00:00",
"entry_mode": "LDE",
"conference_game": false,
"home": {
"name": "Team TBD",
"alias": "TBD",
"id": "e7ce7680-f058-11ee-89df-6558e107cb95"
},
"away": {
"name": "Team TBD",
"alias": "TBD",
"id": "e7ce7680-f058-11ee-89df-6558e107cb95"
}
},
{
"id": "984f87ab-99b7-4ff5-b973-74f18f93d411",
"title": "College Football Playoff - First Round",
"status": "scheduled",
"coverage": "full",
"game_type": "playoff",
"scheduled": "2024-12-21T01:00:00+00:00",
"entry_mode": "LDE",
"conference_game": false,
"home": {
"name": "Team TBD",
"alias": "TBD",
"id": "e7ce7680-f058-11ee-89df-6558e107cb95"
},
"away": {
"name": "Team TBD",
"alias": "TBD",
"id": "e7ce7680-f058-11ee-89df-6558e107cb95"
}
},
{
"id": "72583f68-0a45-49f9-86a3-ae1bc3fdcd22",
"title": "College Football Playoff - First Round",
"status": "scheduled",
"coverage": "full",
"game_type": "playoff",
"scheduled": "2024-12-22T01:00:00+00:00",
"entry_mode": "LDE",
"conference_game": false,
"home": {
"name": "Team TBD",
"alias": "TBD",
"id": "e7ce7680-f058-11ee-89df-6558e107cb95"
},
"away": {
"name": "Team TBD",
"alias": "TBD",
"id": "e7ce7680-f058-11ee-89df-6558e107cb95"
}
},
{
"id": "86b0bb82-8d91-451c-8f2c-0b5688f5cfe3",
"title": "College Football Playoff - First Round",
"status": "scheduled",
"coverage": "full",
"game_type": "playoff",
"scheduled": "2024-12-21T21:00:00+00:00",
"entry_mode": "LDE",
"conference_game": false,
"home": {
"name": "Team TBD",
"alias": "TBD",
"id": "e7ce7680-f058-11ee-89df-6558e107cb95"
},
"away": {
"name": "Team TBD",
"alias": "TBD",
"id": "e7ce7680-f058-11ee-89df-6558e107cb95"
}
}
]
},
{
"id": "bbdc9623-1645-45da-9fe7-1721cc6606ac",
"sequence": 2,
"name": "Quarterfinals",
"games": [
{
"id": "365d49dc-f9b5-4ac9-8aa5-3f432807994f",
"title": "Rose Bowl - Quarterfinal",
"parent_id": "9c77e6a1-d2c6-483a-a01e-150797e94e7e",
"status": "scheduled",
"coverage": "full",
"game_type": "playoff",
"local_game_date": "2025-01-01",
"scheduled": "2025-01-01T22:00:00+00:00",
"entry_mode": "LDE",
"conference_game": false,
"time_zones": {
"venue": "US/Pacific"
},
"venue": {
"id": "18e670be-fbc5-4f4a-afe9-83f8e3e66940",
"name": "Rose Bowl",
"city": "Pasadena",
"state": "CA",
"country": "USA",
"zip": "91103",
"address": "1001 Rose Bowl Drive",
"capacity": 92542,
"surface": "turf",
"roof_type": "outdoor",
"sr_id": "sr:venue:1699",
"location": {
"lat": "34.1613",
"lng": "-118.1676"
}
},
"home": {
"name": "Team TBD",
"alias": "TBD",
"id": "e7ce7680-f058-11ee-89df-6558e107cb95"
},
"away": {
"name": "Team TBD",
"alias": "TBD",
"id": "e7ce7680-f058-11ee-89df-6558e107cb95"
}
},
{
"id": "b807e2e8-cc92-4463-864e-2d40c9758158",
"title": "Peach Bowl - Quarterfinal",
"parent_id": "8c7d356d-d2e8-4cdf-ae43-920c3c618a8f",
"status": "scheduled",
"coverage": "full",
"game_type": "playoff",
"local_game_date": "2025-01-01",
"scheduled": "2025-01-01T18:00:00+00:00",
"entry_mode": "LDE",
"conference_game": false,
"time_zones": {
"venue": "US/Eastern"
},
"venue": {
"id": "dee20e32-4ff3-4994-aa23-efeda80c491e",
"name": "Mercedes-Benz Stadium",
"city": "Atlanta",
"state": "GA",
"country": "USA",
"zip": "30313",
"address": "441 Martin Luther King Jr Dr. NW",
"capacity": 71000,
"surface": "artificial",
"roof_type": "retractable_dome",
"location": {
"lat": "33.7553",
"lng": "-84.4006"
}
},
"home": {
"name": "Team TBD",
"alias": "TBD",
"id": "e7ce7680-f058-11ee-89df-6558e107cb95"
},
"away": {
"name": "Team TBD",
"alias": "TBD",
"id": "e7ce7680-f058-11ee-89df-6558e107cb95"
}
},
{
"id": "dbd47640-90e4-4ded-8fee-459ecab086cd",
"title": "Sugar Bowl - Quarterfinal",
"parent_id": "f263e2f1-b9fa-4818-a4d4-2f9ac5ed4d72",
"status": "scheduled",
"coverage": "full",
"game_type": "playoff",
"local_game_date": "2025-01-01",
"scheduled": "2025-01-02T01:45:00+00:00",
"entry_mode": "LDE",
"conference_game": false,
"time_zones": {
"venue": "US/Central"
},
"venue": {
"id": "f6190c9a-8180-47b6-87a7-1fd2b367a38e",
"name": "Caesars Superdome",
"city": "New Orleans",
"state": "LA",
"country": "USA",
"zip": "70112",
"address": "1500 Sugar Bowl Drive",
"capacity": 76468,
"surface": "artificial",
"roof_type": "dome",
"location": {
"lat": "29.9511",
"lng": "-90.0812"
}
},
"home": {
"name": "Team TBD",
"alias": "TBD",
"id": "e7ce7680-f058-11ee-89df-6558e107cb95"
},
"away": {
"name": "Team TBD",
"alias": "TBD",
"id": "e7ce7680-f058-11ee-89df-6558e107cb95"
}
},
{
"id": "df31c363-3f15-4007-99c5-bcdd89ada78d",
"title": "Fiesta Bowl - Quarterfinal",
"parent_id": "d08b37d4-b4f9-410f-8242-7f8d50d3e2af",
"status": "scheduled",
"coverage": "full",
"game_type": "playoff",
"local_game_date": "2024-12-31",
"scheduled": "2025-01-01T00:30:00+00:00",
"entry_mode": "LDE",
"conference_game": false,
"time_zones": {
"venue": "US/Arizona"
},
"venue": {
"id": "d2c03362-d3da-4f14-a5c3-3172a25174a1",
"name": "State Farm Stadium",
"city": "Glendale",
"state": "AZ",
"country": "USA",
"zip": "85305",
"address": "One Cardinals Drive",
"capacity": 63400,
"surface": "turf",
"roof_type": "retractable_dome",
"location": {
"lat": "33.5276",
"lng": "-112.2626"
}
},
"home": {
"name": "Team TBD",
"alias": "TBD",
"id": "e7ce7680-f058-11ee-89df-6558e107cb95"
},
"away": {
"name": "Team TBD",
"alias": "TBD",
"id": "e7ce7680-f058-11ee-89df-6558e107cb95"
}
}
]
},
{
"id": "4fbfeea3-03ff-4a9b-9872-eccc8de7e21f",
"sequence": 3,
"name": "Semifinals",
"games": [
{
"id": "fca98cb9-4f44-400f-831d-331b573fe857",
"title": "Orange Bowl - Semifinal",
"parent_id": "9d7dd93c-780d-475a-911a-e96bb123d6f3",
"status": "scheduled",
"coverage": "full",
"game_type": "playoff",
"local_game_date": "2025-01-09",
"scheduled": "2025-01-10T00:30:00+00:00",
"entry_mode": "LDE",
"conference_game": false,
"time_zones": {
"venue": "US/Eastern"
},
"venue": {
"id": "280bf6ac-33d9-4e2c-a4bd-af2612f61d00",
"name": "Hard Rock Stadium",
"city": "Miami Gardens",
"state": "FL",
"country": "USA",
"zip": "33056",
"address": "347 Don Shula Drive",
"capacity": 65326,
"surface": "turf",
"roof_type": "outdoor",
"sr_id": "sr:venue:21306",
"location": {
"lat": "25.9583",
"lng": "-80.2396"
}
},
"home": {
"name": "Team TBD",
"alias": "TBD",
"id": "e7ce7680-f058-11ee-89df-6558e107cb95"
},
"away": {
"name": "Team TBD",
"alias": "TBD",
"id": "e7ce7680-f058-11ee-89df-6558e107cb95"
}
},
{
"id": "3f0f86aa-eabc-409b-88a5-7748e05d1ede",
"title": "Cotton Bowl - Semifinal",
"parent_id": "fe4592d6-7e25-4511-8a8c-f7d21644cff7",
"status": "scheduled",
"coverage": "full",
"game_type": "playoff",
"local_game_date": "2025-01-10",
"scheduled": "2025-01-11T00:30:00+00:00",
"entry_mode": "LDE",
"conference_game": false,
"time_zones": {
"venue": "US/Central"
},
"venue": {
"id": "16529037-cf91-48e0-aa24-1dc34fed91d8",
"name": "AT&T Stadium",
"city": "Arlington",
"state": "TX",
"country": "USA",
"zip": "76011",
"address": "1 AT&T Way",
"capacity": 80000,
"surface": "artificial",
"roof_type": "retractable_dome",
"sr_id": "sr:venue:6650",
"location": {
"lat": "32.7480",
"lng": "-97.0934"
}
},
"home": {
"name": "Team TBD",
"alias": "TBD",
"id": "e7ce7680-f058-11ee-89df-6558e107cb95"
},
"away": {
"name": "Team TBD",
"alias": "TBD",
"id": "e7ce7680-f058-11ee-89df-6558e107cb95"
}
}
]
},
{
"id": "3061a6b1-8cf7-497a-8c93-72755d3598e0",
"sequence": 4,
"name": "National Championship",
"games": [
{
"id": "5c0c9ff0-3d99-4844-bc73-03f1719be4f8",
"title": "CFP National Championship",
"parent_id": "d679c1cd-c879-4d1b-8de0-d88ec1916569",
"status": "scheduled",
"coverage": "full",
"game_type": "playoff",
"local_game_date": "2025-01-20",
"scheduled": "2025-01-21T00:30:00+00:00",
"entry_mode": "LDE",
"conference_game": false,
"time_zones": {
"venue": "US/Eastern"
},
"venue": {
"id": "dee20e32-4ff3-4994-aa23-efeda80c491e",
"name": "Mercedes-Benz Stadium",
"city": "Atlanta",
"state": "GA",
"country": "USA",
"zip": "30313",
"address": "441 Martin Luther King Jr Dr. NW",
"capacity": 71000,
"surface": "artificial",
"roof_type": "retractable_dome",
"location": {
"lat": "33.7553",
"lng": "-84.4006"
}
},
"home": {
"name": "Cotton Bowl - Semifinal (win)",
"alias": "Cotton Bowl - Semifinal (win)",
"source": {
"id": "3f0f86aa-eabc-409b-88a5-7748e05d1ede",
"title": "Cotton Bowl - Semifinal",
"status": "scheduled",
"coverage": "full",
"game_type": "playoff",
"scheduled": "2025-01-11T00:30:00+00:00",
"entry_mode": "LDE",
"outcome": "win"
}
},
"away": {
"name": "Orange Bowl - Semifinal (win)",
"alias": "Orange Bowl - Semifinal (win)",
"source": {
"id": "fca98cb9-4f44-400f-831d-331b573fe857",
"title": "Orange Bowl - Semifinal",
"status": "scheduled",
"coverage": "full",
"game_type": "playoff",
"scheduled": "2025-01-10T00:30:00+00:00",
"entry_mode": "LDE",
"outcome": "win"
}
}
}
]
}
]
}
The above code snippet provides an overview of the structure of the College Football Playoff (CFP) tournament, illustrating how matchups are organized within the postseason rounds, such as the First Round, Quarterfinals, Semifinals, and the National Championship.
-
Tournament Structure: The code details each round of the CFP, from the initial First Round games to the National Championship. Each round consists of multiple games, with specific scheduling information and placeholder teams ("Team TBD") used until the actual teams are determined.
-
Team TBD: "Team TBD" indicates that the specific teams participating in the matchups are not yet decided. These placeholders will be replaced with the actual team names once the regular season concludes and the playoff berths are finalized.
Tip - Start Building Your Bracket
You can use this information to start constructing a playoff bracket in your application. By querying the tournament scheduling, you can populate the bracket with the correct matchups, scheduling details, and eventually, the actual team names as they become available. The home and away attributes for each game will be updated with the relevant teams, allowing you to dynamically update the bracket as the tournament progresses.
Tournament Schedule - Recommended Pull Frequency:
- Updates are made in real-time as changes are made to schedules and matchups
- Pull every hour or less depending on your use case.
Note: This feed should be used for schedule info prior to a game start. For the status of a live game, reference a game-endpoint. - The TTL/Cache is two seconds.
Tournament Schedule - Teams Being Populated:
Note: The following code sample represents the structure for the NFL playoff tournament which is identical to the NCAAFB API.
{
"id": "fd927adf-128e-4b36-a1b8-ec7411f4d656",
"name": "NFL Playoffs",
"location": "Las Vegas, NV, USA",
"status": "inprogress",
"league": {
"id": "3c6d318a-6164-4290-9bbc-bf9bb21cc4b8",
"name": "National Football League",
"alias": "NFL"
},
"season": {
"id": "736474f0-adc5-11ee-b174-6f0e0e094ae8",
"year": 2023,
"type": "PST"
},
"rounds": [
{
"id": "562a6827-0022-48d0-9aff-141317c9ee29",
"sequence": 1,
"name": "Wild Card Round",
"bracketed": [
{
"bracket": {
"id": "998dcb19-7060-41c4-b6ad-19efccc0470f",
"name": "NFL Playoffs",
"location": "Las Vegas, NV, USA"
},
"games": [
{
"id": "98ee8b76-6366-4e86-9464-2542e0454357",
"title": "Wild Card",
"status": "closed",
"coverage": "full",
"game_type": "playoff",
"local_game_date": "2024-01-13",
"scheduled": "2024-01-13T21:30:00+00:00",
"entry_mode": "LDE",
"weather": "Partly cloudy Temp: 94 F, Humidity: 53%, Wind: N 2 mph",
"conference_game": true,
"time_zones": {
"venue": "US/Central",
"home": "US/Central",
"away": "US/Eastern"
},
"venue": {
"id": "6a72e5ca-33d0-40af-8e6b-b32a4d3d9346",
"name": "NRG Stadium",
"city": "Houston",
"state": "TX",
"country": "USA",
"zip": "77054",
"address": "One Reliant Park",
"capacity": 72220,
"surface": "artificial",
"roof_type": "retractable_dome",
"sr_id": "sr:venue:2402",
"location": {
"lat": "29.684735",
"lng": "-95.410725"
}
},
"home": {
"name": "Houston Texans",
"alias": "HOU",
"game_number": 1,
"id": "82d2d380-3834-4938-835f-aec541e5ece7"
},
"away": {
"name": "Cleveland Browns",
"alias": "CLE",
"game_number": 1,
"id": "d5a2eb42-8065-4174-ab79-0a6fa820e35e"
},
"scoring": {
"home_points": 6,
"away_points": 0,
"periods": [
{
"period_type": "quarter",
"id": "a6a78d28-2e5e-43a9-9998-1593f148e343",
"number": 1,
"sequence": 1,
"home_points": 6,
"away_points": 0
},
{
"period_type": "quarter",
"id": "37da9eba-dcbf-4525-8636-89f89ce0b14f",
"number": 2,
"sequence": 2,
"home_points": 0,
"away_points": 0
},
{
"period_type": "quarter",
"id": "f4b06ab3-0eeb-4b80-b719-a2d13d38b940",
"number": 3,
"sequence": 3,
"home_points": 0,
"away_points": 0
},
{
"period_type": "quarter",
"id": "6ebe2efe-6f5a-4ef0-b75b-c0a7a2c0bc0a",
"number": 4,
"sequence": 4,
"home_points": 0,
"away_points": 0
},
{
"period_type": "overtime",
"id": "5474e2da-7fa6-4a7c-a256-adcff9fa6cd4",
"number": 1,
"sequence": 5
}
]
}
},
{
"id": "898786ea-e8ee-421f-b67f-578abee9f167",
"title": "Wild Card",
"status": "scheduled",
"coverage": "full",
"game_type": "playoff",
"local_game_date": "2024-01-15",
"scheduled": "2024-01-15T21:30:00+00:00",
"entry_mode": "LDE",
"conference_game": true,
"time_zones": {
"venue": "US/Eastern",
"home": "US/Eastern",
"away": "US/Eastern"
},
"venue": {
"id": "e9e0828e-37fc-4238-a317-49037577dd55",
"name": "Highmark Stadium",
"city": "Orchard Park",
"state": "NY",
"country": "USA",
"zip": "14127",
"address": "One Bills Drive",
"capacity": 71608,
"surface": "artificial",
"roof_type": "outdoor",
"sr_id": "sr:venue:8171",
"location": {
"lat": "42.773826",
"lng": "-78.786589"
}
},
"home": {
"name": "Buffalo Bills",
"alias": "BUF",
"game_number": 2,
"id": "768c92aa-75ff-4a43-bcc0-f2798c2e1724"
},
"away": {
"name": "Pittsburgh Steelers",
"alias": "PIT",
"game_number": 2,
"id": "cb2f9f1f-ac67-424e-9e72-1475cb0ed398"
}
},
{
"id": "06633d8e-3c74-4e77-8cf6-98521b5e5390",
"title": "Wild Card",
"status": "scheduled",
"coverage": "full",
"game_type": "playoff",
"local_game_date": "2024-01-14",
"scheduled": "2024-01-14T21:30:00+00:00",
"entry_mode": "LDE",
"conference_game": true,
"time_zones": {
"venue": "US/Central",
"home": "US/Central",
"away": "US/Central"
},
"venue": {
"id": "1e84213a-ff1f-4c9d-a003-8ee782b25a40",
"name": "AT&T Stadium",
"city": "Arlington",
"state": "TX",
"country": "USA",
"zip": "76011",
"address": "One Legends Way",
"capacity": 80000,
"surface": "artificial",
"roof_type": "retractable_dome",
"sr_id": "sr:venue:6650",
"location": {
"lat": "32.747778",
"lng": "-97.092778"
}
},
"home": {
"name": "Dallas Cowboys",
"alias": "DAL",
"game_number": 1,
"id": "e627eec7-bbae-4fa4-8e73-8e1d6bc5c060"
},
"away": {
"name": "Green Bay Packers",
"alias": "GB",
"game_number": 1,
"id": "a20471b4-a8d9-40c7-95ad-90cc30e46932"
}
},
{
"id": "02ced33a-8ad5-4b3c-bf32-d55091a6de1e",
"title": "Wild Card",
"status": "scheduled",
"coverage": "full",
"game_type": "playoff",
"local_game_date": "2024-01-14",
"scheduled": "2024-01-15T01:15:00+00:00",
"entry_mode": "LDE",
"conference_game": true,
"time_zones": {
"venue": "US/Eastern",
"home": "US/Eastern",
"away": "US/Pacific"
},
"venue": {
"id": "6e3bcf22-277d-4c06-b019-62aded51654f",
"name": "Ford Field",
"city": "Detroit",
"state": "MI",
"country": "USA",
"zip": "48226",
"address": "2000 Brush Street",
"capacity": 65000,
"surface": "artificial",
"roof_type": "dome",
"sr_id": "sr:venue:8181",
"location": {
"lat": "42.339958",
"lng": "-83.045636"
}
},
"home": {
"name": "Detroit Lions",
"alias": "DET",
"game_number": 1,
"id": "c5a59daa-53a7-4de0-851f-fb12be893e9e"
},
"away": {
"name": "Los Angeles Rams",
"alias": "LA",
"game_number": 1,
"id": "2eff2a03-54d4-46ba-890e-2bc3925548f3"
}
},
{
"id": "7da544ca-8ad1-4bdc-b599-17614904ef63",
"title": "Wild Card",
"status": "scheduled",
"coverage": "full",
"game_type": "playoff",
"local_game_date": "2024-01-13",
"scheduled": "2024-01-14T01:30:00+00:00",
"entry_mode": "LDE",
"conference_game": true,
"time_zones": {
"venue": "US/Central",
"home": "US/Central",
"away": "US/Eastern"
},
"venue": {
"id": "2ec4c411-dac2-403d-b091-6b6aa4a0a914",
"name": "GEHA Field at Arrowhead Stadium",
"city": "Kansas City",
"state": "MO",
"country": "USA",
"zip": "64129",
"address": "One Arrowhead Drive",
"capacity": 76416,
"surface": "turf",
"roof_type": "outdoor",
"sr_id": "sr:venue:8189",
"location": {
"lat": "39.049019",
"lng": "-94.484140"
}
},
"home": {
"name": "Kansas City Chiefs",
"alias": "KC",
"game_number": 2,
"id": "6680d28d-d4d2-49f6-aace-5292d3ec02c2"
},
"away": {
"name": "Miami Dolphins",
"alias": "MIA",
"game_number": 2,
"id": "4809ecb0-abd3-451d-9c4a-92a90b83ca06"
}
},
{
"id": "320cc380-60a0-4da2-a14b-6748f3dd03ec",
"title": "Wild Card",
"status": "scheduled",
"coverage": "full",
"game_type": "playoff",
"local_game_date": "2024-01-15",
"scheduled": "2024-01-16T01:15:00+00:00",
"entry_mode": "LDE",
"conference_game": true,
"time_zones": {
"venue": "US/Eastern",
"home": "US/Eastern",
"away": "US/Eastern"
},
"venue": {
"id": "6fccc39c-80bc-4c81-83d9-2d5a848c8c09",
"name": "Raymond James Stadium",
"city": "Tampa",
"state": "FL",
"country": "USA",
"zip": "33607",
"address": "4201 North Dale Mabry Highway",
"capacity": 69218,
"surface": "turf",
"roof_type": "outdoor",
"sr_id": "sr:venue:8205",
"location": {
"lat": "27.976211",
"lng": "-82.503625"
}
},
"home": {
"name": "Tampa Bay Buccaneers",
"alias": "TB",
"game_number": 2,
"id": "4254d319-1bc7-4f81-b4ab-b5e6f3402b69"
},
"away": {
"name": "Philadelphia Eagles",
"alias": "PHI",
"game_number": 2,
"id": "386bdbf9-9eea-4869-bb9a-274b0bc66e80"
}
}
]
}
]
},
{
"id": "2e105f99-ce74-4ce4-a270-e4fa6dabadf3",
"sequence": 2,
"name": "Divisional Round",
"games": [
{
"id": "5cc17ff6-3c25-4fe6-839a-b6e255927666",
"title": "Divisional",
"status": "scheduled",
"coverage": "full",
"game_type": "playoff",
"scheduled": "2024-01-20T21:30:00+00:00",
"entry_mode": "LDE",
"conference_game": true,
"home": {
"name": "Team TBD",
"alias": "TBD",
"id": "23ed0bf0-f058-11ee-9989-93cc4251593a"
},
"away": {
"name": "Team TBD",
"alias": "TBD",
"id": "23ed0bf0-f058-11ee-9989-93cc4251593a"
}
},
{
"id": "36616d16-dd1b-4d57-8686-0af34124782e",
"title": "Divisional",
"status": "scheduled",
"coverage": "full",
"game_type": "playoff",
"scheduled": "2024-01-21T20:00:00+00:00",
"entry_mode": "LDE",
"conference_game": true,
"home": {
"name": "Team TBD",
"alias": "TBD",
"id": "23ed0bf0-f058-11ee-9989-93cc4251593a"
},
"away": {
"name": "Team TBD",
"alias": "TBD",
"id": "23ed0bf0-f058-11ee-9989-93cc4251593a"
}
},
{
"id": "45b019a3-4148-4127-bfdf-7872bfb7d62c",
"title": "Divisional",
"status": "scheduled",
"coverage": "full",
"game_type": "playoff",
"scheduled": "2024-01-21T23:00:00+00:00",
"entry_mode": "LDE",
"conference_game": true,
"home": {
"name": "Team TBD",
"alias": "TBD",
"id": "23ed0bf0-f058-11ee-9989-93cc4251593a"
},
"away": {
"name": "Team TBD",
"alias": "TBD",
"id": "23ed0bf0-f058-11ee-9989-93cc4251593a"
}
},
{
"id": "2ec31b91-0246-435a-b9cd-25456a3c7acd",
"title": "Divisional",
"status": "scheduled",
"coverage": "full",
"game_type": "playoff",
"scheduled": "2024-01-21T01:15:00+00:00",
"entry_mode": "LDE",
"conference_game": true,
"home": {
"name": "Team TBD",
"alias": "TBD",
"id": "23ed0bf0-f058-11ee-9989-93cc4251593a"
},
"away": {
"name": "Team TBD",
"alias": "TBD",
"id": "23ed0bf0-f058-11ee-9989-93cc4251593a"
}
}
]
},
{
"id": "893e58ea-88c3-4735-9493-8c3d036673ed",
"sequence": 3,
"name": "Conference Championship Round",
"games": [
{
"id": "b4291c6f-8f55-459d-94ff-bb929746a03b",
"title": "AFC Championship",
"status": "scheduled",
"coverage": "full",
"game_type": "playoff",
"scheduled": "2024-01-27T23:30:00+00:00",
"entry_mode": "LDE",
"conference_game": true,
"home": {
"name": "Team TBD",
"alias": "TBD",
"id": "23ed0bf0-f058-11ee-9989-93cc4251593a"
},
"away": {
"name": "Team TBD",
"alias": "TBD",
"id": "23ed0bf0-f058-11ee-9989-93cc4251593a"
}
},
{
"id": "3679c141-65b3-41e4-9880-fec6efe733b6",
"title": "NFC Championship",
"status": "scheduled",
"coverage": "full",
"game_type": "bowl",
"scheduled": "2024-01-27T20:00:00+00:00",
"entry_mode": "LDE",
"conference_game": true,
"home": {
"name": "Team TBD",
"alias": "TBD",
"id": "23ed0bf0-f058-11ee-9989-93cc4251593a"
},
"away": {
"name": "Team TBD",
"alias": "TBD",
"id": "23ed0bf0-f058-11ee-9989-93cc4251593a"
}
}
]
},
{
"id": "ee0fc8ff-bf39-40b9-98ec-db2bef3944ff",
"sequence": 4,
"name": "Super Bowl",
"games": [
{
"id": "9e52bfac-0f6c-4e40-b3af-931a3864e67a",
"title": "Super Bowl LIX",
"status": "scheduled",
"coverage": "full",
"game_type": "playoff",
"scheduled": "2024-02-11T23:30:00+00:00",
"entry_mode": "LDE",
"conference_game": false,
"home": {
"name": "AFC Championship (win)",
"alias": "AFC Championship (win)",
"source": {
"id": "b4291c6f-8f55-459d-94ff-bb929746a03b",
"title": "AFC Championship",
"status": "scheduled",
"coverage": "full",
"game_type": "playoff",
"scheduled": "2024-01-27T23:30:00+00:00",
"entry_mode": "LDE",
"outcome": "win"
}
},
"away": {
"name": "NFC Championship (win)",
"alias": "NFC Championship (win)",
"source": {
"id": "3679c141-65b3-41e4-9880-fec6efe733b6",
"title": "NFC Championship",
"status": "scheduled",
"coverage": "full",
"game_type": "bowl",
"scheduled": "2024-01-27T20:00:00+00:00",
"entry_mode": "LDE",
"outcome": "win"
}
}
}
]
}
]
}
Tournament Schedule - Round 1 Done Sample:
Note: The following code sample represents the structure for the NFL playoff tournament which is identical to the NCAAFB API.
{
"id": "fd927adf-128e-4b36-a1b8-ec7411f4d656",
"name": "NFL Playoffs",
"location": "Las Vegas, NV, USA",
"status": "inprogress",
"league": {
"id": "3c6d318a-6164-4290-9bbc-bf9bb21cc4b8",
"name": "National Football League",
"alias": "NFL"
},
"season": {
"id": "736474f0-adc5-11ee-b174-6f0e0e094ae8",
"year": 2023,
"type": "PST"
},
"rounds": [
{
"id": "562a6827-0022-48d0-9aff-141317c9ee29",
"sequence": 1,
"name": "Wild Card Round",
"bracketed": [
{
"bracket": {
"id": "998dcb19-7060-41c4-b6ad-19efccc0470f",
"name": "NFL Playoffs",
"location": "Las Vegas, NV, USA"
},
"games": [
{
"id": "98ee8b76-6366-4e86-9464-2542e0454357",
"title": "Wild Card",
"status": "closed",
"coverage": "full",
"game_type": "playoff",
"local_game_date": "2024-01-13",
"scheduled": "2024-01-13T21:30:00+00:00",
"entry_mode": "LDE",
"weather": "Partly cloudy Temp: 94 F, Humidity: 53%, Wind: N 2 mph",
"conference_game": true,
"time_zones": {
"venue": "US/Central",
"home": "US/Central",
"away": "US/Eastern"
},
"venue": {
"id": "6a72e5ca-33d0-40af-8e6b-b32a4d3d9346",
"name": "NRG Stadium",
"city": "Houston",
"state": "TX",
"country": "USA",
"zip": "77054",
"address": "One Reliant Park",
"capacity": 72220,
"surface": "artificial",
"roof_type": "retractable_dome",
"sr_id": "sr:venue:2402",
"location": {
"lat": "29.684735",
"lng": "-95.410725"
}
},
"home": {
"name": "Houston Texans",
"alias": "HOU",
"game_number": 1,
"id": "82d2d380-3834-4938-835f-aec541e5ece7"
},
"away": {
"name": "Cleveland Browns",
"alias": "CLE",
"game_number": 1,
"id": "d5a2eb42-8065-4174-ab79-0a6fa820e35e"
},
"scoring": {
"home_points": 6,
"away_points": 0,
"periods": [
{
"period_type": "quarter",
"id": "a6a78d28-2e5e-43a9-9998-1593f148e343",
"number": 1,
"sequence": 1,
"home_points": 6,
"away_points": 0
},
{
"period_type": "quarter",
"id": "37da9eba-dcbf-4525-8636-89f89ce0b14f",
"number": 2,
"sequence": 2,
"home_points": 0,
"away_points": 0
},
{
"period_type": "quarter",
"id": "f4b06ab3-0eeb-4b80-b719-a2d13d38b940",
"number": 3,
"sequence": 3,
"home_points": 0,
"away_points": 0
},
{
"period_type": "quarter",
"id": "6ebe2efe-6f5a-4ef0-b75b-c0a7a2c0bc0a",
"number": 4,
"sequence": 4,
"home_points": 0,
"away_points": 0
},
{
"period_type": "overtime",
"id": "5474e2da-7fa6-4a7c-a256-adcff9fa6cd4",
"number": 1,
"sequence": 5
}
]
}
},
{
"id": "898786ea-e8ee-421f-b67f-578abee9f167",
"title": "Wild Card",
"status": "closed",
"coverage": "full",
"game_type": "playoff",
"local_game_date": "2024-01-15",
"scheduled": "2024-01-15T21:30:00+00:00",
"entry_mode": "LDE",
"weather": "Partly cloudy Temp: 81 F, Humidity: 44%, Wind: SW 6 mph",
"conference_game": true,
"time_zones": {
"venue": "US/Eastern",
"home": "US/Eastern",
"away": "US/Eastern"
},
"venue": {
"id": "e9e0828e-37fc-4238-a317-49037577dd55",
"name": "Highmark Stadium",
"city": "Orchard Park",
"state": "NY",
"country": "USA",
"zip": "14127",
"address": "One Bills Drive",
"capacity": 71608,
"surface": "artificial",
"roof_type": "outdoor",
"sr_id": "sr:venue:8171",
"location": {
"lat": "42.773826",
"lng": "-78.786589"
}
},
"home": {
"name": "Buffalo Bills",
"alias": "BUF",
"game_number": 2,
"id": "768c92aa-75ff-4a43-bcc0-f2798c2e1724"
},
"away": {
"name": "Pittsburgh Steelers",
"alias": "PIT",
"game_number": 2,
"id": "cb2f9f1f-ac67-424e-9e72-1475cb0ed398"
},
"scoring": {
"home_points": 6,
"away_points": 0,
"periods": [
{
"period_type": "quarter",
"id": "c3c61b67-cef7-4e74-ae9e-43bc3994c6b7",
"number": 1,
"sequence": 1,
"home_points": 6,
"away_points": 0
},
{
"period_type": "quarter",
"id": "352e2ea3-de64-4be1-9de6-da9ffb23085f",
"number": 2,
"sequence": 2,
"home_points": 0,
"away_points": 0
},
{
"period_type": "quarter",
"id": "f324be0c-fcb6-48da-9c8c-5f49bc9cba31",
"number": 3,
"sequence": 3,
"home_points": 0,
"away_points": 0
},
{
"period_type": "quarter",
"id": "a3a3a4cb-e620-40ad-a8cf-096cb295220e",
"number": 4,
"sequence": 4,
"home_points": 0,
"away_points": 0
}
]
}
},
{
"id": "06633d8e-3c74-4e77-8cf6-98521b5e5390",
"title": "Wild Card",
"status": "closed",
"coverage": "full",
"game_type": "playoff",
"local_game_date": "2024-01-14",
"scheduled": "2024-01-14T21:30:00+00:00",
"entry_mode": "LDE",
"weather": "Sunny Temp: 93 F, Humidity: 47%, Wind: SSW 9 mph",
"conference_game": true,
"time_zones": {
"venue": "US/Central",
"home": "US/Central",
"away": "US/Central"
},
"venue": {
"id": "1e84213a-ff1f-4c9d-a003-8ee782b25a40",
"name": "AT&T Stadium",
"city": "Arlington",
"state": "TX",
"country": "USA",
"zip": "76011",
"address": "One Legends Way",
"capacity": 80000,
"surface": "artificial",
"roof_type": "retractable_dome",
"sr_id": "sr:venue:6650",
"location": {
"lat": "32.747778",
"lng": "-97.092778"
}
},
"home": {
"name": "Dallas Cowboys",
"alias": "DAL",
"game_number": 1,
"id": "e627eec7-bbae-4fa4-8e73-8e1d6bc5c060"
},
"away": {
"name": "Green Bay Packers",
"alias": "GB",
"game_number": 1,
"id": "a20471b4-a8d9-40c7-95ad-90cc30e46932"
},
"scoring": {
"home_points": 6,
"away_points": 0,
"periods": [
{
"period_type": "quarter",
"id": "c14d56bc-4ec0-4380-98d8-a0fcf8b75bc2",
"number": 1,
"sequence": 1,
"home_points": 6,
"away_points": 0
},
{
"period_type": "quarter",
"id": "4ce794b3-dfb1-4002-8237-43bf8a436a16",
"number": 2,
"sequence": 2,
"home_points": 0,
"away_points": 0
},
{
"period_type": "quarter",
"id": "a1866bb2-b770-4368-b43a-f8a41d7c6d86",
"number": 3,
"sequence": 3,
"home_points": 0,
"away_points": 0
},
{
"period_type": "quarter",
"id": "7264756f-498c-4971-8b69-7f5fed8dffe9",
"number": 4,
"sequence": 4,
"home_points": 0,
"away_points": 0
},
{
"period_type": "overtime",
"id": "60611a11-99e6-409d-b59a-bd7130b83ad5",
"number": 1,
"sequence": 5,
"home_points": 0,
"away_points": 0
},
{
"period_type": "overtime",
"id": "53fa87c2-0105-408b-b8c6-c5ba7c7d5b98",
"number": 2,
"sequence": 6,
"home_points": 0,
"away_points": 0
},
{
"period_type": "overtime",
"id": "ca5e977b-c1e8-41f6-8536-165fb16708ca",
"number": 3,
"sequence": 7
}
]
}
},
{
"id": "02ced33a-8ad5-4b3c-bf32-d55091a6de1e",
"title": "Wild Card",
"status": "closed",
"coverage": "full",
"game_type": "playoff",
"local_game_date": "2024-01-14",
"scheduled": "2024-01-15T01:15:00+00:00",
"entry_mode": "LDE",
"weather": "Partly cloudy Temp: 80 F, Humidity: 58%, Wind: SE 7 mph",
"conference_game": true,
"time_zones": {
"venue": "US/Eastern",
"home": "US/Eastern",
"away": "US/Pacific"
},
"venue": {
"id": "6e3bcf22-277d-4c06-b019-62aded51654f",
"name": "Ford Field",
"city": "Detroit",
"state": "MI",
"country": "USA",
"zip": "48226",
"address": "2000 Brush Street",
"capacity": 65000,
"surface": "artificial",
"roof_type": "dome",
"sr_id": "sr:venue:8181",
"location": {
"lat": "42.339958",
"lng": "-83.045636"
}
},
"home": {
"name": "Detroit Lions",
"alias": "DET",
"game_number": 1,
"id": "c5a59daa-53a7-4de0-851f-fb12be893e9e"
},
"away": {
"name": "Los Angeles Rams",
"alias": "LA",
"game_number": 1,
"id": "2eff2a03-54d4-46ba-890e-2bc3925548f3"
},
"scoring": {
"home_points": 0,
"away_points": 6,
"periods": [
{
"period_type": "quarter",
"id": "99e74911-ebce-4875-845a-7b17b4d310ea",
"number": 1,
"sequence": 1,
"home_points": 0,
"away_points": 6
},
{
"period_type": "quarter",
"id": "ce0c202e-3292-4b4d-a682-7da8cce59d9c",
"number": 2,
"sequence": 2,
"home_points": 0,
"away_points": 0
},
{
"period_type": "quarter",
"id": "a33b265d-4697-4821-a4e6-d9d0fde6c941",
"number": 3,
"sequence": 3,
"home_points": 0,
"away_points": 0
},
{
"period_type": "quarter",
"id": "b2c1cf5b-2740-4b44-8fe0-9c9e3fa32cbe",
"number": 4,
"sequence": 4,
"home_points": 0,
"away_points": 0
}
]
}
},
{
"id": "7da544ca-8ad1-4bdc-b599-17614904ef63",
"title": "Wild Card",
"status": "closed",
"coverage": "full",
"game_type": "playoff",
"local_game_date": "2024-01-13",
"scheduled": "2024-01-14T01:30:00+00:00",
"entry_mode": "LDE",
"weather": "Sunny Temp: 87 F, Humidity: 59%, Wind: SSW 14 mph",
"conference_game": true,
"time_zones": {
"venue": "US/Central",
"home": "US/Central",
"away": "US/Eastern"
},
"venue": {
"id": "2ec4c411-dac2-403d-b091-6b6aa4a0a914",
"name": "GEHA Field at Arrowhead Stadium",
"city": "Kansas City",
"state": "MO",
"country": "USA",
"zip": "64129",
"address": "One Arrowhead Drive",
"capacity": 76416,
"surface": "turf",
"roof_type": "outdoor",
"sr_id": "sr:venue:8189",
"location": {
"lat": "39.049019",
"lng": "-94.484140"
}
},
"home": {
"name": "Kansas City Chiefs",
"alias": "KC",
"game_number": 2,
"id": "6680d28d-d4d2-49f6-aace-5292d3ec02c2"
},
"away": {
"name": "Miami Dolphins",
"alias": "MIA",
"game_number": 2,
"id": "4809ecb0-abd3-451d-9c4a-92a90b83ca06"
},
"scoring": {
"home_points": 6,
"away_points": 0,
"periods": [
{
"period_type": "quarter",
"id": "c3be26b7-ac12-4176-a1b2-32b257b21f46",
"number": 1,
"sequence": 1,
"home_points": 6,
"away_points": 0
},
{
"period_type": "quarter",
"id": "142eeb69-4305-41df-ab0a-c71c1e33eb0a",
"number": 2,
"sequence": 2,
"home_points": 0,
"away_points": 0
},
{
"period_type": "quarter",
"id": "18fda225-4671-478a-b515-2cf8f905ff0e",
"number": 3,
"sequence": 3,
"home_points": 0,
"away_points": 0
},
{
"period_type": "quarter",
"id": "e3117c3e-3a85-4d9e-a81f-7b71b64c8da8",
"number": 4,
"sequence": 4,
"home_points": 0,
"away_points": 0
},
{
"period_type": "overtime",
"id": "2108461b-ded6-43df-832c-198ce1f5e44e",
"number": 1,
"sequence": 5
}
]
}
},
{
"id": "320cc380-60a0-4da2-a14b-6748f3dd03ec",
"title": "Wild Card",
"status": "created",
"coverage": "full",
"game_type": "playoff",
"local_game_date": "2024-01-15",
"scheduled": "2024-01-16T01:15:00+00:00",
"entry_mode": "LDE",
"weather": "Partly cloudy Temp: 93 F, Humidity: 60%, Wind: NNE 8 mph",
"conference_game": true,
"time_zones": {
"venue": "US/Eastern",
"home": "US/Eastern",
"away": "US/Eastern"
},
"venue": {
"id": "6fccc39c-80bc-4c81-83d9-2d5a848c8c09",
"name": "Raymond James Stadium",
"city": "Tampa",
"state": "FL",
"country": "USA",
"zip": "33607",
"address": "4201 North Dale Mabry Highway",
"capacity": 69218,
"surface": "turf",
"roof_type": "outdoor",
"sr_id": "sr:venue:8205",
"location": {
"lat": "27.976211",
"lng": "-82.503625"
}
},
"home": {
"name": "Tampa Bay Buccaneers",
"alias": "TB",
"game_number": 2,
"id": "4254d319-1bc7-4f81-b4ab-b5e6f3402b69"
},
"away": {
"name": "Philadelphia Eagles",
"alias": "PHI",
"game_number": 2,
"id": "386bdbf9-9eea-4869-bb9a-274b0bc66e80"
}
}
]
}
]
},
{
"id": "2e105f99-ce74-4ce4-a270-e4fa6dabadf3",
"sequence": 2,
"name": "Divisional Round",
"games": [
{
"id": "36616d16-dd1b-4d57-8686-0af34124782e",
"title": "Divisional",
"status": "scheduled",
"coverage": "full",
"game_type": "playoff",
"scheduled": "2024-01-21T20:00:00+00:00",
"entry_mode": "LDE",
"conference_game": true,
"time_zones": {
"home": "US/Central"
},
"home": {
"name": "Dallas Cowboys",
"alias": "DAL",
"game_number": 3,
"id": "e627eec7-bbae-4fa4-8e73-8e1d6bc5c060"
},
"away": {
"name": "Team TBD",
"alias": "TBD",
"id": "23ed0bf0-f058-11ee-9989-93cc4251593a"
}
},
{
"id": "5cc17ff6-3c25-4fe6-839a-b6e255927666",
"title": "Divisional",
"status": "scheduled",
"coverage": "full",
"game_type": "playoff",
"scheduled": "2024-01-20T21:30:00+00:00",
"entry_mode": "LDE",
"conference_game": true,
"time_zones": {
"home": "US/Eastern",
"away": "US/Central"
},
"home": {
"name": "Baltimore Ravens",
"alias": "BAL",
"game_number": 1,
"id": "ebd87119-b331-4469-9ea6-d51fe3ce2f1c"
},
"away": {
"name": "Houston Texans",
"alias": "HOU",
"game_number": 3,
"id": "82d2d380-3834-4938-835f-aec541e5ece7"
}
},
{
"id": "45b019a3-4148-4127-bfdf-7872bfb7d62c",
"title": "Divisional",
"status": "scheduled",
"coverage": "full",
"game_type": "playoff",
"scheduled": "2024-01-21T23:00:00+00:00",
"entry_mode": "LDE",
"conference_game": true,
"time_zones": {
"home": "US/Eastern",
"away": "US/Central"
},
"home": {
"name": "Buffalo Bills",
"alias": "BUF",
"game_number": 3,
"id": "768c92aa-75ff-4a43-bcc0-f2798c2e1724"
},
"away": {
"name": "Kansas City Chiefs",
"alias": "KC",
"game_number": 3,
"id": "6680d28d-d4d2-49f6-aace-5292d3ec02c2"
}
},
{
"id": "2ec31b91-0246-435a-b9cd-25456a3c7acd",
"title": "Divisional",
"status": "scheduled",
"coverage": "full",
"game_type": "playoff",
"scheduled": "2024-01-21T01:15:00+00:00",
"entry_mode": "LDE",
"conference_game": true,
"time_zones": {
"home": "US/Pacific",
"away": "US/Pacific"
},
"home": {
"name": "San Francisco 49ers",
"alias": "SF",
"game_number": 1,
"id": "f0e724b0-4cbf-495a-be47-013907608da9"
},
"away": {
"name": "Los Angeles Rams",
"alias": "LA",
"game_number": 3,
"id": "2eff2a03-54d4-46ba-890e-2bc3925548f3"
}
}
]
},
{
"id": "893e58ea-88c3-4735-9493-8c3d036673ed",
"sequence": 3,
"name": "Conference Championship Round",
"games": [
{
"id": "b4291c6f-8f55-459d-94ff-bb929746a03b",
"title": "AFC Championship",
"status": "scheduled",
"coverage": "full",
"game_type": "playoff",
"scheduled": "2024-01-27T23:30:00+00:00",
"entry_mode": "LDE",
"conference_game": true,
"home": {
"name": "Team TBD",
"alias": "TBD",
"id": "23ed0bf0-f058-11ee-9989-93cc4251593a"
},
"away": {
"name": "Team TBD",
"alias": "TBD",
"id": "23ed0bf0-f058-11ee-9989-93cc4251593a"
}
},
{
"id": "3679c141-65b3-41e4-9880-fec6efe733b6",
"title": "NFC Championship",
"status": "scheduled",
"coverage": "full",
"game_type": "bowl",
"scheduled": "2024-01-27T20:00:00+00:00",
"entry_mode": "LDE",
"conference_game": true,
"home": {
"name": "Team TBD",
"alias": "TBD",
"id": "23ed0bf0-f058-11ee-9989-93cc4251593a"
},
"away": {
"name": "Team TBD",
"alias": "TBD",
"id": "23ed0bf0-f058-11ee-9989-93cc4251593a"
}
}
]
},
{
"id": "ee0fc8ff-bf39-40b9-98ec-db2bef3944ff",
"sequence": 4,
"name": "Super Bowl",
"games": [
{
"id": "9e52bfac-0f6c-4e40-b3af-931a3864e67a",
"title": "Super Bowl LIX",
"status": "scheduled",
"coverage": "full",
"game_type": "playoff",
"scheduled": "2024-02-11T23:30:00+00:00",
"entry_mode": "LDE",
"conference_game": false,
"home": {
"name": "AFC Championship (win)",
"alias": "AFC Championship (win)",
"source": {
"id": "b4291c6f-8f55-459d-94ff-bb929746a03b",
"title": "AFC Championship",
"status": "scheduled",
"coverage": "full",
"game_type": "playoff",
"scheduled": "2024-01-27T23:30:00+00:00",
"entry_mode": "LDE",
"outcome": "win"
}
},
"away": {
"name": "NFC Championship (win)",
"alias": "NFC Championship (win)",
"source": {
"id": "3679c141-65b3-41e4-9880-fec6efe733b6",
"title": "NFC Championship",
"status": "scheduled",
"coverage": "full",
"game_type": "bowl",
"scheduled": "2024-01-27T20:00:00+00:00",
"entry_mode": "LDE",
"outcome": "win"
}
}
}
]
}
]
}
3. Track the Tournament Summary
Along with tracking live games in each matchup, you can use the Tournament Summary feed to get the latest status on the entire tournament, making it easy to update your bracket with the most current information.
{
"id": "1ccd543f-ae53-46bb-96f7-cae4df2180ca",
"name": "NCAAFB Playoff Tournament",
"location": "The Custerdome",
"status": "inprogress",
"start_date": "2024-07-02",
"end_date": "2024-07-03",
"league": {
"id": "26c1246a-2fc3-4b7e-8999-1685d3ab4676",
"name": "NCAA Football",
"alias": "NCAAFB"
},
"season": {
"id": "908fbc20-f5c7-11ee-a306-c311afc28263",
"year": 2024,
"type": "REG"
},
"brackets": [
{
"id": "09e3a68a-0cbb-41de-9770-dbaac45b88c7",
"name": "Bracket B",
"participants": [
{
"id": "43838b74-5606-4a4c-b8bb-9e6072e45031",
"name": "Bryant Bulldogs",
"market": "Bryant",
"franchise_id": "43838b74-5606-4a4c-b8bb-9e6072e45031",
"seed": 1,
"type": "team"
},
{
"id": "5fb529f6-f6b3-4892-a188-9b38addcc9a3",
"name": "Buffalo Bulls",
"market": "Buffalo",
"franchise_id": "5fb529f6-f6b3-4892-a188-9b38addcc9a3",
"seed": 2,
"type": "team"
}
]
},
{
"id": "3aae5c4f-1f0d-4651-a4e5-c9fafed8dd3e",
"name": "Bracket A",
"participants": [
{
"id": "b33187c4-a906-4cff-b15b-f1bcb410a743",
"name": "Arkansas State Red Wolves",
"market": "Arkansas State",
"franchise_id": "b33187c4-a906-4cff-b15b-f1bcb410a743",
"seed": 1,
"type": "team"
},
{
"id": "9f40a53c-d4bc-4d58-8208-2227634f9454",
"name": "Air Force Falcons",
"market": "Air Force",
"franchise_id": "9f40a53c-d4bc-4d58-8208-2227634f9454",
"seed": 2,
"type": "team"
}
]
}
]
}
The above code sample represents the structure for an NCAA Football (NCAAFB) playoff tournament. It outlines key details such as the tournament's name, location, status, and the organization of participating teams into brackets.
Populating Your Playoff Brackets:
To build a playoff bracket on your application, you can use this structure to populate and display the teams participating in each bracket, along with their respective seeds. Each team has an id, name, market, and franchise_id, which can be used to fetch additional team details or statistics if needed. The bracket information (id and name) allows you to categorize matchups and display them in a visual bracket format.
Tournament Summary - Recommended Pull Frequency:
- Update Frequency
- Schedule information is updated in real-time as changes are made.
- Brackets and seeds will be available shortly after they are made official.
- Pull daily or less depending on your use case.
- The TTL/Cache is two seconds.
Matchup Behavior in NCAAFB Playoffs
Similar to the NFL playoffs, the image depicts a bracket showing the progression of matchups in the 2023 FCS Playoffs, moving from the Quarterfinal Round to the Semifinal Round and ultimately to the Finals.
-
First Round (Not Depicted in the Illustration):
-
The FCS Playoffs begin with the First Round, which includes teams that did not secure a first-round bye. This round typically involves the lower-seeded conference champions and at-large bids.
-
Winners from the First Round advance to the Quarterfinals, where they face the top-seeded teams that had a bye during the First Round.
First Round Bye
A "bye" is a pass that allows a team to skip a round of the playoffs. In the FCS, the top-seeded teams in the tournament (usually the highest-ranked teams) automatically advance to the Quarterfinals without playing in the First Round.
-
-
Quarterfinals:
-
Following the First Round, the Quarterfinals match the advancing teams against the top-seeded teams in the tournament.
-
For example:
- South Dakota State vs. Villanova: South Dakota State wins with a score of 23-12.
- Idaho vs. Albany: Albany wins with a score of 30-22.
- Montana vs. Furman: Montana wins with a score of 35-28.
- South Dakota vs. North Dakota State: North Dakota State wins with a score of 45-17.
-
The victors move on to the Semifinals.
-
-
Semifinals:
-
The Semifinals determine the finalists who will compete for the FCS National Championship.
-
For example:
- South Dakota State vs. Albany: South Dakota State wins with a score of 59-0.
- Montana vs. North Dakota State: Montana wins with a score of 31-29.
-
South Dakota State and Montana advance to the National Championship.
-
-
FCS National Championship:
-
The final round of the playoffs, where the two semifinal winners face off for the FCS title.
-
South Dakota State defeats Montana with a score of 23-3 to win the FCS National Championship.
-
Note: Each playoff game is a single-elimination contest, meaning the losing team is eliminated from further contention.
Differences between FCS and CFP
The Football Championship Subdivision (FCS) and the College Football Playoff (CFP) represent two distinct postseason formats in college football, each with unique structures and rules.
-
Tournament Size:
- FCS: 24 teams, multiple rounds (First Round, Second Round, Quarterfinals, Semifinals, Championship).
- CFP: 4 teams (expanding to 12 in 2024), fewer rounds (Quarterfinals, Semifinals, Championship).
-
Byes:
- FCS: Top 8 teams get a bye in the First Round.
- CFP: Top 4 teams receive a bye in the First Round (starting 2024).
-
Round Names:
- FCS: First Round, Second Round, Quarterfinals, Semifinals, FCS National Championship.
- CFP: Quarterfinals, Semifinals, CFP National Championship.
-
Structure:
- FCS: More teams, longer tournament.
- CFP: Fewer teams, more direct path to the championship.
Updated about 2 months ago