Tracking Playoffs
The NFL playoffs are a single-elimination tournament held after the regular season to determine the NFL champion. Teams from the AFC and NFC compete, culminating in the Super Bowl, where the two conference champions face off. The API exposes the postseason two ways: as a PST season through the Season Schedule feed, and as a tournament through the tournament feeds, which add rounds, brackets, seeds, and game-to-game wiring.
This scenario is commonly used to:
- Render a playoff bracket with seeds
- Fill matchups as "Team TBD" placeholders resolve to confirmed teams
- Track playoff games with the same drilldowns as regular-season games
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.
Relevant Feeds
| Feed | Scope | Use |
|---|---|---|
| Tournament List | {season_year}/PST | Discover the playoffs tournament and its ID |
| Tournament Schedule | tournament GUID | Rounds, matchups, venues, and source wiring |
| Tournament Summary | tournament GUID | Participants, seeds, and tournament status |
High-Level Workflow
Integration Steps
1. Confirm the season
The tournament feeds are addressed by season_year and a season_type of PST. Confirm the season is available first:
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.
2. Discover the tournament
Call the Tournament List with season_type set to PST; the NFL Playoffs are a postseason tournament. The response names the tournament, its location, status, and dates, and provides the tournament ID the other two feeds take. The 2024 postseason lists one tournament:
GET https://api.sportradar.com/nfl/official/trial/v7/en/tournaments/2024/PST/schedule.json
x-api-key: YOUR_API_KEY{
"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"
}
]
}
Playoff Schedule AvailabilityThe initial playoff schedule (with TBD matchups) will be available shortly after the regular season schedule is released.
3. Pull the tournament schedule
Using the tournament ID, pull the Tournament Schedule for the date, time, and location of each matchup in the NFL Playoffs. Before berths are set, every slot holds the "Team TBD" placeholder, and the Super Bowl's home and away slots point at the two championship games through source objects whose outcome of win names the feeder each slot waits on:
GET https://api.sportradar.com/nfl/official/trial/v7/en/tournaments/d128603c-516d-4814-83bf-b14085503e1a/schedule.json
x-api-key: YOUR_API_KEY{
"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": "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"
}
}
}
]
}
]
}The response is shown trimmed to two Wild Card games and the Super Bowl round; the full response carries all four rounds. It lays out how matchups are organized within the postseason rounds: the Wild Card Round, Divisional Round, Conference Championships, and the Super Bowl.
- Tournament structure: the response includes 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") hold each slot until the teams are determined.
- Team TBD: indicates that the specific teams for a matchup are not yet decided. These placeholders are replaced with the confirmed team names and IDs once the regular season concludes and playoff berths are finalized. The placeholder is the TBD team from the Teams feed, described under ID Handling.
Start Building Your BracketYou can use this information to start constructing a playoff bracket in your application. By querying the tournament schedule, you can populate the bracket with the correct matchups and scheduling details, and eventually the team names as they become available. The
homeandawayattributes for each game are updated with the relevant teams, allowing you to update the bracket dynamically as the tournament progresses.
4. Read seeds from the Summary
Along with tracking live games in each matchup, use the Tournament Summary for the latest status on the entire tournament, which makes it easy to keep your bracket current. It carries the bracket's participants with their seed values, keyed to the same team GUIDs as everywhere else. The 2024 season's completed bracket:
GET https://api.sportradar.com/nfl/official/trial/v7/en/tournaments/d128603c-516d-4814-83bf-b14085503e1a/summary.json
x-api-key: YOUR_API_KEY{
"id": "d128603c-516d-4814-83bf-b14085503e1a",
"name": "NFL Playoffs",
"location": "New Orleans, LA, USA",
"status": "closed",
"start_date": "2025-01-11",
"end_date": "2025-02-09",
"league": {
"id": "3c6d318a-6164-4290-9bbc-bf9bb21cc4b8",
"name": "National Football League",
"alias": "NFL"
},
"season": {
"id": "26a6a4e0-dfc9-11ee-8f7c-27de425212d4",
"year": 2024,
"type": "PST"
},
"brackets": [
{
"id": "8e830e68-ae05-4499-8eb5-9a8af7e490ab",
"name": "NFL Playoffs",
"location": "New Orleans, LA, USA",
"participants": [
{
"id": "768c92aa-75ff-4a43-bcc0-f2798c2e1724",
"name": "Buffalo Bills",
"market": "Buffalo",
"franchise_id": "26f22bc6-1fb9-4c01-80cc-908342490651",
"seed": 2,
"type": "team"
},
{
"id": "2eff2a03-54d4-46ba-890e-2bc3925548f3",
"name": "Los Angeles Rams",
"market": "Los Angeles",
"franchise_id": "6947fd02-bb27-4f11-93da-c7c5baab53dc",
"seed": 4,
"type": "team"
},
{
"id": "6680d28d-d4d2-49f6-aace-5292d3ec02c2",
"name": "Kansas City Chiefs",
"market": "Kansas City",
"franchise_id": "5d239f9e-ef6a-46a6-83c2-94500fd119be",
"seed": 1,
"type": "team"
},
{
"id": "a20471b4-a8d9-40c7-95ad-90cc30e46932",
"name": "Green Bay Packers",
"market": "Green Bay",
"franchise_id": "d06bf286-748f-4482-b256-8be705d41d16",
"seed": 7,
"type": "team"
},
{
"id": "4254d319-1bc7-4f81-b4ab-b5e6f3402b69",
"name": "Tampa Bay Buccaneers",
"market": "Tampa Bay",
"franchise_id": "e3790b3a-f7fc-4c19-8016-3e29b623f6d0",
"seed": 3,
"type": "team"
},
{
"id": "82d2d380-3834-4938-835f-aec541e5ece7",
"name": "Houston Texans",
"market": "Houston",
"franchise_id": "0b23e38e-a1f2-44e5-97c5-70b6a0fa2ff0",
"seed": 4,
"type": "team"
},
{
"id": "cb2f9f1f-ac67-424e-9e72-1475cb0ed398",
"name": "Pittsburgh Steelers",
"market": "Pittsburgh",
"franchise_id": "8dfe8626-6970-4e88-90dd-ea735c3d5cc3",
"seed": 6,
"type": "team"
},
{
"id": "ebd87119-b331-4469-9ea6-d51fe3ce2f1c",
"name": "Baltimore Ravens",
"market": "Baltimore",
"franchise_id": "677f94d8-2228-47be-881f-6680fd0af994",
"seed": 3,
"type": "team"
},
{
"id": "1f6dcffb-9823-43cd-9ff4-e7a8466749b5",
"name": "Los Angeles Chargers",
"market": "Los Angeles",
"franchise_id": "a74d513a-dd7f-440d-a366-249f8f8dd97d",
"seed": 5,
"type": "team"
},
{
"id": "ce92bd47-93d5-4fe9-ada4-0fc681e6caa0",
"name": "Denver Broncos",
"market": "Denver",
"franchise_id": "32e2db10-be6d-41ed-9e3d-5b30ba164b99",
"seed": 7,
"type": "team"
},
{
"id": "33405046-04ee-4058-a950-d606f8c30852",
"name": "Minnesota Vikings",
"market": "Minnesota",
"franchise_id": "eea5f772-bd6b-4dc6-a7ef-118708f3a726",
"seed": 5,
"type": "team"
},
{
"id": "22052ff7-c065-42ee-bc8f-c4691c50e624",
"name": "Washington Commanders",
"market": "Washington",
"franchise_id": "d7376957-e63b-4bc9-b82b-d087fc0ec83a",
"seed": 6,
"type": "team"
},
{
"id": "386bdbf9-9eea-4869-bb9a-274b0bc66e80",
"name": "Philadelphia Eagles",
"market": "Philadelphia",
"franchise_id": "8eefc537-0493-4de8-8d64-2c091d3f5887",
"seed": 2,
"type": "team"
},
{
"id": "c5a59daa-53a7-4de0-851f-fb12be893e9e",
"name": "Detroit Lions",
"market": "Detroit",
"franchise_id": "6e9e3a7d-d35d-47a2-bc8d-4855fe35ab7a",
"seed": 1,
"type": "team"
}
]
}
]
}To build a playoff bracket, use this structure to populate and display the teams in each bracket along with their seeds. Each participant carries an id, name, market, and franchise_id, which key into additional team details or statistics if needed. The bracket's id and name let you categorize matchups and display them in a visual bracket format.
5. Follow the bracket wiring
Once berths are set, a populated round nests as rounds[] > bracketed[] > games[], with each game carrying its bracket, venue, and, once played, scoring. Later rounds keep "Team TBD" until their feeders finish. In the 2023 season's tournament below, the Wild Card round is populated and its first game has closed with scoring filled in, while the Divisional Round slots are still placeholders:
GET https://api.sportradar.com/nfl/official/trial/v7/en/tournaments/fd927adf-128e-4b36-a1b8-ec7411f4d656/schedule.json
x-api-key: YOUR_API_KEY{
"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",
"conference_game": true,
"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
}
},
{
"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,
"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": "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"
}
}
]
}
]
}The response is shown trimmed to two Wild Card games and the first Divisional game. Teams advance to the next round on a 2-minute timer after the previous game moves to complete. As the Wild Card round finishes, the winners land in the Divisional slots: Houston travels to Baltimore, Kansas City to Buffalo, and Los Angeles to San Francisco, while Baltimore and San Francisco, the bye teams, appear for the first time in this round. Dallas hosts a slot still marked TBD because the Philadelphia at Tampa Bay game is only in created:
{
"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": "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",
"conference_game": true,
"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"
}
}
]
}
]
}The response is shown trimmed to the unfinished Wild Card game and the Divisional Round.
6. Follow a postseason round by round
Joining the Summary's seeds to the schedule's rounds yields the bracket view. The card below shows the progression of the 2025 postseason from the Divisional Round through Super Bowl LX, drawn from the Tournament Schedule:
- Wild Card Round (not depicted): 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 Wild Card weekend.
First Round ByeA "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 Round, the Divisional Round matches the advancing teams against the top-seeded teams in each conference:
- Houston at New England: New England wins 28-16
- Los Angeles at Chicago: Los Angeles wins 20-17
- San Francisco at Seattle: Seattle wins 41-6
- Buffalo at Denver: Denver wins 33-30
- The victors move on to the Conference Championship Round.
- Conference Championship Round: determines the conference champions who will compete in the Super Bowl:
- Los Angeles at Seattle: Seattle wins 31-27
- New England at Denver: New England wins 10-7
- Seattle and New England advance to the Super Bowl.
- Super Bowl: the final round of the playoffs, where the two conference champions face off for the NFL title. Seattle defeats New England 29-13 to win Super Bowl LX.
Note: each playoff game is a single-elimination contest, meaning the losing team is eliminated from further contention.
Common Use Cases
- Bracket view: Tournament Summary for participants and seeds plus Tournament Schedule for round-by-round wiring; the bracket
idandnamegroup the matchups for display - Playoff gamecast: the game IDs from either view plus the Tracking Live Games workflow
- Playoff schedule listing: the
PSTSeason Schedule through the Pulling Schedules workflow, for the postseason in the same week-and-game shape as the regular season - Advancement tracking: refresh the Tournament Schedule as games reach
completeand move teams forward ashomeandawayslots resolve from "Team TBD" to confirmed teams
Best Practices
- Address the playoffs with a
season_typeofPST; the tournament GUID from the Tournament List keys both the Tournament Schedule and the Tournament Summary - Use the TBD placeholder team convention from ID Handling for unresolved slots in schedule views, and
sourceobjects for bracket logic; placeholders resolve to confirmed team names and IDs once the regular season concludes and playoff berths are finalized - Re-pull the Tournament Schedule after each playoff game reaches
complete: teams advance to the next round on a 2-minute timer, and schedule information updates in real time as changes are made. Pull every hour or less depending on your use case. Use this feed for schedule information before kickoff; for the status of a live game, reference a game endpoint - Pull the Tournament Summary daily or less depending on your use case; brackets and seeds are available shortly after they are made official
- The Super Bowl entry carries a
parent_idshared by every season's Super Bowl, so one key follows the event across years - Both tournament feeds carry a two-second TTL; the full cadence chart is on Update Frequencies
Updated 12 days ago
