Integration GuidesReference Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Integration Guides

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

FeedScopeUse
Season Schedule{season_year}/PSTPlayoff games as a schedule
Tournament List{season_year}/{season_type}Discover the tournament and its ID
Tournament Scheduletournament GUIDRounds, brackets, and matchup wiring
Tournament Summarytournament GUIDParticipants and seeds
Postgame Standings{season_year}/REGThe race that sets the field


High-Level Workflow

Two Views of the PostseasonSame games, two structures
PST Season Schedule weeks and games
Playoffs weekUnited Bowl week
Flat weeks of games with venue, broadcast, and scoring. Use it for schedules, scores, and boxscore drilldowns.
Tournament feeds rounds, brackets, seeds
roundsbracketedgamessource wiring
Tournament Summary carries seeded participants; Tournament Schedule wires later rounds to earlier games through home and away source objects.
Game IDs match across both views, so either one drills into the same Boxscore, Play-by-Play, and Statistics feeds.


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:

UFL PLAYOFFS2026 Postseason
Playoff Game #1
4DCDC Defenders28
1ORLOrlando Storm22
Playoff Game #2
3LOULouisville Kings29
2STLSt. Louis Battlehawks20
United Bowl
4DCDC Defenders20
3LOULouisville Kings27
CHAMPION · LOUISVILLE KINGS
Seeds from the Tournament Summary; scores from the PST schedule.


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 source objects 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 created preloads

Did this page help you?