Skip to main content
GET
Get event schedule for a sport

Endpoint details

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.

Authorizations

X-TheRundown-Key
string
header
required

Recommended API key request header for new integrations

Path Parameters

sportID
integer
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, 17=UEFA Europa League (listed as UEFAEURO; 33 returns no events), 34=Liga MX, 38=ATP Tennis, 39=WTA Tennis, 40=PGA Tour Golf, 41=Formula 1

Query Parameters

limit
integer
default:50
season_year
integer
season_type_id
integer
from
string<date>
team_id
integer
last_event_uuid
string

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

sort
enum<string>
default:asc
Available options:
asc,
desc
conference_id
integer
division_id
integer
include
enum<string>

Set to teams to add away_team_detail and home_team_detail objects to each schedule entry.

Available options:
teams

Response

200 - application/json

Schedule

schedules
object[]