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 NFL playoffs are a single-elimination tournament held after the regular season to determine the NFL champion. Teams from both the American Football Conference (AFC) and National Football Conference (NFC) compete, culminating in the Super Bowl, where the two conference champions face off.
You can access playoff data using these feeds:
- The Tournament List endpoint provides a summarized list of all tournaments scheduled for the given season including the NFL Playoffs.
- 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 NFL 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 Postseason Tournament List
Call the Tournament List endpoint to get the list of available tournaments and tournament ids for the season.
The NFL Playoffs are a postseason tournament so you want to ensure that your season_type is PST.
Playoff Schedule Availability
The initial playoff schedule (with TBD matchups) will be available shortly after the regular season schedule is released.
The following samples shows a list of tournaments for the 2024 NFL Postseason.
{
"league": {
"id": "3c6d318a-6164-4290-9bbc-bf9bb21cc4b8",
"name": "National Football League",
"alias": "NFL"
},
"season": {
"id": "26a6a4e0-dfc9-11ee-8f7c-27de425212d4",
"year": 2024,
"type": "PST"
},
"tournaments": [
{
"id": "d128603c-516d-4814-83bf-b14085503e1a",
"name": "NFL Playoffs",
"location": "New Orleans, LA, USA",
"status": "scheduled",
"start_date": "2025-01-11",
"end_date": "2025-02-09"
}
]
}
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 NFL Playoffs.
{
"id": "d128603c-516d-4814-83bf-b14085503e1a",
"name": "NFL Playoffs",
"location": "New Orleans, LA, USA",
"status": "scheduled",
"league": {
"id": "3c6d318a-6164-4290-9bbc-bf9bb21cc4b8",
"name": "National Football League",
"alias": "NFL"
},
"season": {
"id": "26a6a4e0-dfc9-11ee-8f7c-27de425212d4",
"year": 2024,
"type": "PST"
},
"rounds": [
{
"id": "ea9de897-45d5-42f6-8d6b-98fab83c7a57",
"sequence": 1,
"name": "Wild Card Round",
"games": [
{
"id": "6b71f468-5099-48ab-8957-e64d90f09857",
"title": "Wild Card",
"status": "scheduled",
"coverage": "full",
"game_type": "playoff",
"scheduled": "2025-01-12T21: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": "82356cf4-56a3-4472-94a2-7774f33f0740",
"title": "Wild Card",
"status": "scheduled",
"coverage": "full",
"game_type": "playoff",
"scheduled": "2025-01-11T18: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": "2adf422c-e1e2-4cc9-8fd6-7ae89e73080e",
"title": "Wild Card",
"status": "scheduled",
"coverage": "full",
"game_type": "playoff",
"scheduled": "2025-01-11T21: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": "01d418ca-1579-46c0-b4b7-318b60d4fdac",
"title": "Wild Card",
"status": "scheduled",
"coverage": "full",
"game_type": "playoff",
"scheduled": "2025-01-14T01: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": "c74313f1-23c4-43a0-aaac-35c3b8b14ea6",
"title": "Wild Card",
"status": "scheduled",
"coverage": "full",
"game_type": "playoff",
"scheduled": "2025-01-12T01: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": "9a8e9530-ed68-4c1d-ba71-7e82ac643aae",
"title": "Wild Card",
"status": "scheduled",
"coverage": "full",
"game_type": "playoff",
"scheduled": "2025-01-13T01: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": "a3947d81-6bc5-44b4-8b74-876c957ae53c",
"sequence": 2,
"name": "Divisional Round",
"games": [
{
"id": "4cee1421-117a-46ab-b458-c265a72fc946",
"title": "Divisional",
"status": "scheduled",
"coverage": "full",
"game_type": "playoff",
"scheduled": "2025-01-19T01: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": "aafd386c-94e0-4856-ac49-84a7fed3e7f6",
"title": "Divisional",
"status": "scheduled",
"coverage": "full",
"game_type": "playoff",
"scheduled": "2025-01-19T20: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": "c2523570-f40a-4438-8cb2-6ca5ec3af805",
"title": "Divisional",
"status": "scheduled",
"coverage": "full",
"game_type": "playoff",
"scheduled": "2025-01-19T23: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": "9e0aac39-b534-48ee-8a88-af0214ecf20d",
"title": "Divisional",
"status": "scheduled",
"coverage": "full",
"game_type": "playoff",
"scheduled": "2025-01-18T21: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": "13802de7-61d9-4f4e-8f7b-e5e32aedd830",
"sequence": 3,
"name": "Conference Championship Round",
"games": [
{
"id": "a8ff18fc-11c8-4fcc-8343-2273d4d20489",
"title": "NFC Championship",
"status": "scheduled",
"coverage": "full",
"game_type": "playoff",
"scheduled": "2025-01-26T20: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": "3d05fcdb-d1f1-4de9-850d-6ef41b3f883d",
"title": "AFC Championship",
"status": "scheduled",
"coverage": "full",
"game_type": "playoff",
"scheduled": "2025-01-26T23: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": "5d6c9534-1c62-4161-87f4-4d81fa8b9edd",
"sequence": 4,
"name": "Super Bowl",
"games": [
{
"id": "ca9d8f84-8e7b-4ee7-a310-54c2e3ca4edc",
"title": "Super Bowl LIX",
"parent_id": "f6c2b12d-966c-41a5-98a7-054620fba38b",
"status": "scheduled",
"coverage": "full",
"game_type": "playoff",
"local_game_date": "2025-02-09",
"scheduled": "2025-02-09T23:30:00+00:00",
"entry_mode": "LDE",
"conference_game": false,
"time_zones": {
"venue": "US/Central"
},
"venue": {
"id": "3c85d89a-ec66-4983-acd5-1381d6c8673a",
"name": "Caesars Superdome",
"city": "New Orleans",
"state": "LA",
"country": "USA",
"zip": "70112",
"address": "1500 Sugar Bowl Drive",
"capacity": 73208,
"surface": "artificial",
"roof_type": "dome",
"sr_id": "sr:venue:8195",
"location": {
"lat": "29.950928",
"lng": "-90.080876"
}
},
"home": {
"name": "NFC Championship (win)",
"alias": "NFC Championship (win)",
"source": {
"id": "a8ff18fc-11c8-4fcc-8343-2273d4d20489",
"title": "NFC Championship",
"status": "scheduled",
"coverage": "full",
"game_type": "playoff",
"scheduled": "2025-01-26T20:00:00+00:00",
"entry_mode": "LDE",
"outcome": "win"
}
},
"away": {
"name": "AFC Championship (win)",
"alias": "AFC Championship (win)",
"source": {
"id": "3d05fcdb-d1f1-4de9-850d-6ef41b3f883d",
"title": "AFC Championship",
"status": "scheduled",
"coverage": "full",
"game_type": "playoff",
"scheduled": "2025-01-26T23:30:00+00:00",
"entry_mode": "LDE",
"outcome": "win"
}
}
}
]
}
]
}
This above code snippet provides an overview of the structure of the NFL Playoff tournament, illustrating how matchups are organized within the postseason rounds, such as the Wild Card Round, Divisional Round, Conference Championships, and the Super Bowl.
- Tournament Structure: The code details each round of the NFL Playoffs, from the initial Wild Card games to the Super Bowl. 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 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:
- Schedule info is updated in realtime as changes are made. The initial playoff schedule (with TBD matchups) will be available shortly after the regular season schedule is released.
- Teams will advance to the next round on a 2-minute timer after the previous game moves to
completestatus
- Teams will advance to the next round on a 2-minute timer after the previous game moves to
- 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:
{
"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:
{
"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.
Note: The following code sample represents the structure for an NCAA Football (NCAAFB) playoff tournament which is identical to the NFL API.
{
"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"
}
]
}
]
}
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 the NFL Playoffs
The image depicts a bracket showing the progression of matchups in the 2024 NFL Playoffs, moving from the Divisional Round to the Championship Round and ultimately to the Super Bowl.
-
Wild Card Playoffs (Not Depicted in the Illustration):
- The NFL Playoffs begin with the Wild Card Round. This round involves teams that did not secure a first-round bye, typically the lower-seeded division winners and the highest-seeded wild card teams from each conference.
- Winners from the Wild Card Round advance to the Divisional Round, where they face the top-seeded teams that had a bye during the Wild Card weekend.
First Round Bye
A "bye" is essentially a pass that allows a team to skip a round of the playoffs. In the NFL, the top-seeded teams in each conference (usually the #1 seed) automatically advance to the Divisional Round without having to play in the Wild Card Round. This is known as securing a "first-round bye."
-
Divisional Round:
- Following the Wild Card Playoffs, the Divisional Round matches the advancing teams against the top-seeded teams in each conference.
- For example:
- Baltimore vs. Houston: Baltimore wins with a score of 34-10.
- Buffalo vs. Kansas City: Kansas City wins with a score of 27-24.
- San Francisco vs. Green Bay: San Francisco wins with a score of 24-21.
- Detroit vs. Tampa Bay: Detroit wins with a score of 31-23.
- The victors move on to the Championship Round.
-
Championship Round:
- The Championship Round determines the conference champions who will compete in the Super Bowl.
- For example:
- Baltimore vs. Kansas City: Kansas City wins with a score of 17-10.
- San Francisco vs. Detroit: San Francisco wins with a score of 34-31.
- Kansas City and San Francisco advance to the Super Bowl.
-
Super Bowl:
- The final round of the playoffs, where the two conference champions face off for the NFL title.
- Kansas City defeats San Francisco with a score of 25-22 to win the Super Bowl.
Note: Each playoff game is a single-elimination contest, meaning the losing team is eliminated from further contention.
Updated about 2 months ago