V2 Futures

Get one futures competition, with progress and leaders

Changed on

Returns one futures/outright competition event, the same envelope and event object shape as GET /api/v2/sports/{sportID}/futures (meta.delta_last_id, events with a single event carrying event_id, sport_id, event_date, settle_by, event_status, settlement, schedule, markets), plus up to three optional detail-only keys not served on the listing. Early access: requires an Ultra plan or higher.

progress: the competition's live non-odds state (a golf leaderboard, a team-sport standings table), refreshed on its own cycle independent of the odds board. entries[].participant_id is the same participant ID space markets[].participants[].id uses, so a progress row joins directly to a price. Omitted entirely (never null) when no progress document exists yet for the competition: "priced, no odds-board progress" is the normal state for a fresh team-championship board, not a degraded response. See Competition Stats (Progress) for the full field-by-field breakdown of both kinds live today.

leaders / player_leaders: optional curated season-stats leaderboards, team-grain and player-grain respectively, for a hand-verified set of sports. Both reuse the same {stat, stat_id, season_year, entries[]} shape and are omitted entirely (never an empty array) when the sport is not curated or no stat rows exist yet; see Competition Stats (Progress) for the curated sport list and the two distinct entry ID spaces.

Settled competitions are always served here. Unlike the listing (which hides settled markets and terminal events unless include_settled=true), this is a deep link to a specific competition you already hold the ID for, and it keeps working after settlement, with the graded results visible in settlement. There is no include_settled parameter on this endpoint.

get/api/v2/sports/{sportID}/futures/{eventID}

Request

  • Base URL
    https://therundown.io
  • Auth
    API key in header X-TheRundown-Key

Path parameters

sportIDinteger required

Sport ID. Common values: 1=NCAAF, 2=NFL, 3=MLB, 4=NBA, 5=NCAAB, 6=NHL, 7=UFC, 8=WNBA, 9=CFL, 10=MLS, 11=EPL, 16=UEFA Champions League, 33=UEFA Europa League, 34=Liga MX, 38=ATP Tennis, 39=WTA Tennis, 40=PGA Tour Golf, 41=Formula 1

eventIDstring required

Canonical V2 event ID from the event_id field returned by event endpoints

Query parameters

market_idsstring

Comma-separated market IDs, intersected with the future-class market set. When omitted, all future-class markets are returned.

affiliate_idsstring

Comma-separated sportsbook/affiliate IDs to filter. Common values include DraftKings (19), FanDuel (23), BetMGM (22), BookMaker (7), BetCRIS (9), Pinnacle (3), Polymarket US (31), Circa Sports (32), Bet105 (33), and Heritage Sports (34). Availability varies by sport and market. On V2 event endpoints (/api/v2/sports/{sportID}/events/{date}, /api/v2/events/{eventID}, and their openers/closing siblings), affiliate_ids=0 is a scores-only sentinel: the response keeps events, scores, and status and omits markets and price objects. Other endpoints that share this parameter treat affiliate_ids as a sportsbook filter only.

Response

Futures event retrieved successfully

Example response

{
  "meta": {
    "count": 50,
    "has_more": true,
    "total": 73
  },
  "events": [
    {
      "event_id": "a3d1f9f94f220a45cfd944181569cc46",
      "sport_id": 2,
      "event_status": "STATUS_SCHEDULED",
      "schedule": {
        "event_name": "NFL Super Bowl Winner (2026 Season)",
        "season_year": 2026,
        "league_name": "PGA Tour"
      },
      "markets": [
        {
          "market_id": 1,
          "name": "Money Line",
          "participants": [
            {
              "id": 51,
              "name": "New England Patriots"
            }
          ]
        }
      ],
      "progress": {
        "kind": "league_standings",
        "phase": {
          "status": "STATUS_IN_PROGRESS",
          "label": "Round 3 of 4",
          "unit": "round",
          "current": 3,
          "total": 4
        }
      },
      "leaders": [
        {
          "stat": "Total Yards",
          "stat_id": 1120,
          "season_year": 2025,
          "entries": [
            {
              "participant_id": 61,
              "name": "Buffalo Bills",
              "value": 6432,
              "rank": 1
            }
          ]
        }
      ],
      "player_leaders": [
        {
          "stat": "Total Yards",
          "stat_id": 1120,
          "season_year": 2025,
          "entries": [
            {
              "participant_id": 61,
              "name": "Buffalo Bills",
              "value": 6432,
              "rank": 1
            }
          ]
        }
      ]
    }
  ]
}

Changes

    • breaking

      response property meta/delta_last_id list-of-types was widened by adding types integer to media type application/json of response 200

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status