V1 Sports

Get event schedule for a sport

Changed on

Returns scheduled events for a sport. This endpoint is non-billable: every successful response, including nonempty ones, consumes zero data points, so X-Datapoints is omitted. Usage window headers are still returned for keys with an active plan.

get/api/v1/sports/{sportID}/schedule

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

Query parameters

limitinteger
season_yearinteger
season_type_idinteger
fromstring date
team_idinteger
last_event_uuidstring

Cursor for pagination: pass the last event UUID from previous page

sort'asc' | 'desc'
conference_idinteger
division_idinteger
include_teamsstring

Include team details when present

Response

Schedule

Changes

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status