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.
Accessing Available Seasons (Prerequisite)
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 Postseason Tournament List
Call the Tournament List endpoint to get the list of available tournaments and tournament ids for the season.
The below sample shows a list of tournaments for the 2025-26 NCAA Football season.
2025 NCAAFB Tournaments
{
"league": {
"id": "26c1246a-2fc3-4b7e-8999-1685d3ab4676",
"name": "NCAA Football",
"alias": "NCAAFB"
},
"season": {
"id": "754e4990-efc7-11ef-bb2a-5d2d22b9215e",
"year": 2025,
"type": "REG"
},
"tournaments": [
{
"id": "39a7ae3c-6097-42d2-913b-4a06f109e78e",
"name": "FCS Playoffs",
"location": "Nashville, TN, USA",
"status": "scheduled",
"start_date": "2025-11-29",
"end_date": "2026-01-05"
},
{
"id": "b760eaa9-3e31-499e-a655-2ed5bb05d9f7",
"name": "College Football Playoff",
"location": "Miami, FL, USA",
"status": "scheduled",
"start_date": "2025-12-19",
"end_date": "2026-01-19"
}
]
}2. Pull the Tournament Schedule
Using the tournament id from the above endpoint, pull the Tournament Schedule to get the date, time and location for each matchup in a tournament.
2024 NCAAFB Playoff Schedule (w/ TBD Matchups)
{
"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 BracketYou 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.
In Progress Tournament Schedule (NFL Sample)
{
"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.
Tournament Schedule (Round 1 Complete - NFL)
{
"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.
2024 NCAAFB CFP Tournament Summary
{
"id": "77b49a1b-e3a0-4833-9ab0-799367dd97b1",
"name": "College Football Playoff",
"location": "Atlanta, GA, USA",
"status": "closed",
"start_date": "2024-12-20",
"end_date": "2025-01-20",
"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": "67ed9991-b34b-4f6c-8313-e7e202c36291",
"name": "College Football Playoff",
"location": "Atlanta, GA, USA",
"participants": [
{
"id": "fa0eb091-8e35-49c7-b00f-269794a99a61",
"name": "Indiana Hoosiers",
"market": "Indiana",
"franchise_id": "fa0eb091-8e35-49c7-b00f-269794a99a61",
"seed": 10,
"type": "team"
},
{
"id": "d7f19bff-74e7-4b71-a221-12dfeb144fd8",
"name": "Notre Dame Fighting Irish",
"market": "Notre Dame",
"franchise_id": "d7f19bff-74e7-4b71-a221-12dfeb144fd8",
"seed": 7,
"type": "team"
},
{
"id": "ae68bc50-4135-47b5-b2f1-03d0669e54c8",
"name": "Texas Longhorns",
"market": "Texas",
"franchise_id": "ae68bc50-4135-47b5-b2f1-03d0669e54c8",
"seed": 5,
"type": "team"
},
{
"id": "619c5384-3660-44ac-b2ad-597ccb3854c7",
"name": "SMU Mustangs",
"market": "SMU",
"franchise_id": "619c5384-3660-44ac-b2ad-597ccb3854c7",
"seed": 11,
"type": "team"
},
{
"id": "2eef738d-c637-4b12-b8df-4b79efcce71e",
"name": "Georgia Bulldogs",
"market": "Georgia",
"franchise_id": "2eef738d-c637-4b12-b8df-4b79efcce71e",
"seed": 2,
"type": "team"
},
{
"id": "5c218a3b-a013-4037-97b6-603c9502b701",
"name": "Oregon Ducks",
"market": "Oregon",
"franchise_id": "5c218a3b-a013-4037-97b6-603c9502b701",
"seed": 1,
"type": "team"
},
{
"id": "95404613-f4f0-4280-ac27-85419215f8d1",
"name": "Clemson Tigers",
"market": "Clemson",
"franchise_id": "95404613-f4f0-4280-ac27-85419215f8d1",
"seed": 12,
"type": "team"
},
{
"id": "35aa5295-ad07-4b95-aad2-63d1d5bf9009",
"name": "Boise State Broncos",
"market": "Boise State",
"franchise_id": "35aa5295-ad07-4b95-aad2-63d1d5bf9009",
"seed": 3,
"type": "team"
},
{
"id": "00fd8418-0e62-4366-9a2a-d5f72850066c",
"name": "Arizona State Sun Devils",
"market": "Arizona State",
"franchise_id": "00fd8418-0e62-4366-9a2a-d5f72850066c",
"seed": 4,
"type": "team"
},
{
"id": "eeb3ce19-6ddd-4c91-afab-811c6cc81974",
"name": "Penn State Nittany Lions",
"market": "Penn State",
"franchise_id": "eeb3ce19-6ddd-4c91-afab-811c6cc81974",
"seed": 6,
"type": "team"
},
{
"id": "9ecb9f6b-df4a-4a92-aaa4-5d50a5286bdd",
"name": "Tennessee Volunteers",
"market": "Tennessee",
"franchise_id": "9ecb9f6b-df4a-4a92-aaa4-5d50a5286bdd",
"seed": 9,
"type": "team"
},
{
"id": "9a6d6f3f-021e-4ddd-8fac-ac4766239d87",
"name": "Ohio State Buckeyes",
"market": "Ohio State",
"franchise_id": "9a6d6f3f-021e-4ddd-8fac-ac4766239d87",
"seed": 8,
"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
The below image depicts a bracket of matchups for the 2025 FBS College Football Playoff. Leverage the above endpoints to create a similar visual in your solution.
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:
- CFP: 12 teams
- FCS: 24 teams
-
Byes:
- CFP: Top 4 teams receive a bye in the First Round
- FCS: Top 8 teams receive a bye in the First Round
-
Round Names:
- CFP: First Round, Quarterfinals, Semifinals, CFP National Championship.
- FCS: First Round, Second Round, Quarterfinals, Semifinals, FCS National Championship.
Updated 22 days ago