Skip to main content

Endpoints

Returns all available sports with their IDs and names. No authentication required.

Example Response

Returns all teams for a given sport.

Example Response

Returns dates with events for the sport. For US Central dates, use offset=300 during daylight saving time (CDT) and offset=360 during standard time (CST).

Example Response

Each entry is the earliest event start on that day, shifted by offset minutes. The first 10 characters are the caller-local date. Pass format=epoch for Unix seconds.

Example Response

Example Response


List All Sports

This endpoint does not require authentication.
Returns every sport supported by TheRundown with its numeric sport_id and display name. Use these IDs in all other endpoints that accept a sportID path parameter.

Get Teams by Sport

Returns all teams for a given sport, including team IDs, names, abbreviations, and mascots.

Parameters


Get Available Dates

Returns dates that have events for the specified sport. Useful for building date pickers.

Parameters


Get Dates by Multiple Sport IDs

Returns dates with events for multiple sports at once, keyed by sport ID.

Parameters


Get Events by Date (Cross-Sport)

Returns schedule listing dates grouped by sport (sport_id → date strings) for a given date. Useful for seeing which sports have action on a date.

Get Divisions

Returns all divisions for a sport. Available for sports with divisional structures (NFL, MLB, NHL, etc.).

Get Conferences

Returns all conferences for a sport.