Tracking Playoffs
The UFL postseason is compact: two playoff games one weekend, the United Bowl the next. The API exposes it two ways: as a PST season through the schedule feeds, 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
- Track playoff games with the same drilldowns as regular-season games
- Resolve who advances into the championship
Relevant Feeds
| Feed | Scope | Use |
|---|---|---|
| Season Schedule | {season_year}/PST | Playoff games as a schedule |
| Tournament List | {season_year}/{season_type} | Discover the tournament and its ID |
| Tournament Schedule | tournament GUID | Rounds, brackets, and matchup wiring |
| Tournament Summary | tournament GUID | Participants and seeds |
| Postgame Standings | {season_year}/REG | The race that sets the field |
High-Level Workflow
Integration Steps
1. Read the postseason as a schedule
The PST Season Schedule returns the playoff weekends as weeks, with each game carrying a title ("Playoff Game #1", "United Bowl") alongside the usual schedule fields. The United Bowl plays at a neutral site, which the game's neutral_site flag records:
{
"id": "4123d3de-ea19-4e5a-9320-d29026eb3df6",
"year": 2026,
"type": "PST",
"name": "PST",
"weeks": [
{
"id": "d94fdb5c-f123-4e6a-a116-5c83835aa0b8",
"sequence": 1,
"title": "Playoffs",
"games": [
{
"id": "5753e3ca-b266-440a-896a-45ce508bfd6b",
"status": "closed",
"scheduled": "2026-06-07T19:00:00+00:00",
"entry_mode": "LDE",
"sr_id": "sr:match:71848178",
"game_type": "playoff",
"conference_game": false,
"title": "Playoff Game #1",
"home": {
"id": "0dc60b30-b8f0-11f0-9440-2f32b8d49d12",
"name": "Orlando Storm",
"alias": "ORL",
"sr_id": "sr:competitor:1320812"
},
"away": {
"id": "a3407150-c045-11ee-b66f-5d382d09dbaf",
"name": "DC Defenders",
"alias": "DC",
"sr_id": "sr:competitor:661851"
},
"scoring": {
"home_points": 22,
"away_points": 28
}
},
{
"id": "3be181e4-ae87-4523-94b6-228536c1c920",
"status": "closed",
"scheduled": "2026-06-07T22:00:00+00:00",
"entry_mode": "LDE",
"sr_id": "sr:match:71848180",
"game_type": "playoff",
"conference_game": false,
"title": "Playoff Game #2",
"home": {
"id": "d4799bc0-c045-11ee-ad92-cf16c0a8aa31",
"name": "St. Louis Battlehawks",
"alias": "STL",
"sr_id": "sr:competitor:661855"
},
"away": {
"id": "ff1f47e0-b8ef-11f0-9440-2f32b8d49d12",
"name": "Louisville Kings",
"alias": "LOU",
"sr_id": "sr:competitor:1320808"
},
"scoring": {
"home_points": 20,
"away_points": 29
}
}
]
},
{
"id": "9f36f25e-246f-4e9a-a1ef-96d169cc3337",
"sequence": 2,
"title": "United Bowl",
"games": [
{
"id": "475db4da-d8a9-49ee-b7a4-1239f916533a",
"status": "closed",
"scheduled": "2026-06-13T19:00:00+00:00",
"entry_mode": "LDE",
"sr_id": "sr:match:71976470",
"game_type": "playoff",
"conference_game": false,
"title": "United Bowl",
"neutral_site": true,
"home": {
"id": "ff1f47e0-b8ef-11f0-9440-2f32b8d49d12",
"name": "Louisville Kings",
"alias": "LOU",
"sr_id": "sr:competitor:1320808"
},
"away": {
"id": "a3407150-c045-11ee-b66f-5d382d09dbaf",
"name": "DC Defenders",
"alias": "DC",
"sr_id": "sr:competitor:661851"
},
"scoring": {
"home_points": 27,
"away_points": 20
}
}
]
}
]
}The games are shown trimmed to their core fields.
2. Discover the tournament
The Tournament List for the PST season names the championship tournament, its location, status, and dates, and provides the tournament GUID the other two feeds take:
{
"league": {
"id": "d441365f-cfab-49d6-9976-6c95d91fdef7",
"name": "United Football League",
"alias": "UFL"
},
"season": {
"id": "4123d3de-ea19-4e5a-9320-d29026eb3df6",
"year": 2026,
"type": "PST"
},
"tournaments": [
{
"id": "7d0adf90-81ee-4472-aecc-ef86ef057dfd",
"name": "UFL Championship",
"location": "Washington, DC, USA",
"status": "closed",
"start_date": "2026-06-07",
"end_date": "2026-06-13"
}
]
}3. Read seeds from the Summary
The Tournament Summary carries the bracket's participants with their seed values, wired to the same team GUIDs as everywhere else. Seeding follows the regular-season table tracked on the Tracking Standings page:
{
"id": "7d0adf90-81ee-4472-aecc-ef86ef057dfd",
"name": "UFL Championship",
"location": "Washington, DC, USA",
"status": "closed",
"start_date": "2026-06-07",
"end_date": "2026-06-13",
"league": {
"id": "d441365f-cfab-49d6-9976-6c95d91fdef7",
"name": "United Football League",
"alias": "UFL"
},
"season": {
"id": "4123d3de-ea19-4e5a-9320-d29026eb3df6",
"year": 2026,
"type": "PST"
},
"brackets": [
{
"id": "bae1c2bb-110b-466c-8da4-bbe7709b2b50",
"name": "UFL Championship",
"location": "Washington, DC, USA",
"participants": [
{
"id": "0dc60b30-b8f0-11f0-9440-2f32b8d49d12",
"name": "Orlando Storm",
"market": "Orlando",
"franchise_id": "11d5a000-b8f0-11f0-9440-2f32b8d49d12",
"seed": 1,
"type": "team"
},
{
"id": "ff1f47e0-b8ef-11f0-9440-2f32b8d49d12",
"name": "Louisville Kings",
"market": "Louisville",
"franchise_id": "073e9890-b8f0-11f0-9440-2f32b8d49d12",
"seed": 3,
"type": "team"
},
{
"id": "d4799bc0-c045-11ee-ad92-cf16c0a8aa31",
"name": "St. Louis Battlehawks",
"market": "St. Louis",
"franchise_id": "ddbe59a0-c045-11ee-ad92-cf16c0a8aa31",
"seed": 2,
"type": "team"
},
{
"id": "a3407150-c045-11ee-b66f-5d382d09dbaf",
"name": "DC Defenders",
"market": "DC",
"franchise_id": "ab5b2e20-c045-11ee-b66f-5d382d09dbaf",
"seed": 4,
"type": "team"
}
]
}
]
}4. Follow the bracket wiring
The Tournament Schedule nests rounds[] > bracketed[] > games[]. Before a matchup is decided, a later-round slot references its feeder games through source objects with an outcome; the championship's home slot below reads "the winner of Playoff Game #2". Game IDs match the PST schedule, so the same Boxscore, Play-by-Play, and Statistics drilldowns apply:
{
"id": "7d0adf90-81ee-4472-aecc-ef86ef057dfd",
"name": "UFL Championship",
"location": "Washington, DC, USA",
"status": "closed",
"season": {
"id": "4123d3de-ea19-4e5a-9320-d29026eb3df6",
"year": 2026,
"type": "PST"
},
"rounds": [
{
"id": "e9d7bc91-94ba-4c6d-87a7-a9ed17be4fea",
"sequence": 2,
"name": "Round 2",
"bracketed": [
{
"bracket": {
"id": "bae1c2bb-110b-466c-8da4-bbe7709b2b50",
"name": "UFL Championship",
"location": "Washington, DC, USA"
},
"games": [
{
"id": "475db4da-d8a9-49ee-b7a4-1239f916533a",
"status": "closed",
"scheduled": "2026-06-13T19:00:00+00:00",
"title": "United Bowl",
"game_type": "playoff",
"home": {
"name": "Louisville Kings",
"alias": "LOU",
"game_number": 2,
"id": "ff1f47e0-b8ef-11f0-9440-2f32b8d49d12",
"source": {
"id": "3be181e4-ae87-4523-94b6-228536c1c920",
"title": "Playoff Game #2",
"status": "closed",
"coverage": "full",
"game_type": "playoff",
"scheduled": "2026-06-07T22:00:00+00:00",
"entry_mode": "LDE",
"outcome": "win"
}
},
"away": {
"name": "DC Defenders",
"alias": "DC",
"game_number": 2,
"id": "a3407150-c045-11ee-b66f-5d382d09dbaf",
"source": {
"id": "5753e3ca-b266-440a-896a-45ce508bfd6b",
"title": "Playoff Game #1",
"status": "closed",
"coverage": "full",
"game_type": "playoff",
"scheduled": "2026-06-07T19:00:00+00:00",
"entry_mode": "LDE",
"outcome": "win"
}
}
}
]
}
]
}
]
}The response is shown trimmed to the championship round. Joining the Summary's seeds to the schedule's scores yields the bracket view; club marks are placeholders for your own or licensed assets:
Common Use Cases
- Bracket view: Tournament Summary for seeds plus Tournament Schedule for wiring
- Playoff gamecast: the PST schedule plus the Tracking Live Games workflow
- Race-to-the-playoffs: regular-season standings clinch markers feeding a bracket preview
Best Practices
- Use the TBD placeholder team convention from ID Handling for unresolved slots in schedule views, and
sourceobjects for bracket logic - Re-pull the tournament feeds after each playoff game reaches
complete; slots resolve to concrete teams as feeders finish - Postseason games use the same status lifecycle as the regular season, including
createdpreloads
Updated about 1 month ago
