> ## Documentation Index
> Fetch the complete documentation index at: https://docs.therundown.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Sports

> List sports and get the dates, teams, divisions and conferences for each, plus dates across several sports

## Endpoints

> [accordion] GET /api/v2/sports — List all sports
>
> Returns all available sports with their IDs and names. No authentication required.
>
> ```bash theme={null}
> curl --fail-with-body "https://therundown.io/api/v2/sports"
> ```
>
> ### Example Response
>
> ```json theme={null}
> {
>   "sports": [
>     { "sport_id": 1, "sport_name": "NCAA Football" },
>     { "sport_id": 2, "sport_name": "NFL" },
>     { "sport_id": 3, "sport_name": "MLB" },
>     { "sport_id": 4, "sport_name": "NBA" },
>     { "sport_id": 5, "sport_name": "NCAA Men's Basketball" },
>     { "sport_id": 6, "sport_name": "NHL" },
>     { "sport_id": 7, "sport_name": "UFC/MMA" },
>     { "sport_id": 8, "sport_name": "WNBA" },
>     { "sport_id": 10, "sport_name": "MLS" },
>     { "sport_id": 11, "sport_name": "EPL" },
>     { "sport_id": 12, "sport_name": "FRA1" },
>     { "sport_id": 13, "sport_name": "GER1" },
>     { "sport_id": 14, "sport_name": "ESP1" },
>     { "sport_id": 15, "sport_name": "ITA1" },
>     { "sport_id": 16, "sport_name": "UEFACHAMP" },
>     { "sport_id": 17, "sport_name": "UEFAEURO" },
>     { "sport_id": 18, "sport_name": "FIFA" },
>     { "sport_id": 19, "sport_name": "JPN1" },
>     { "sport_id": 20, "sport_name": "IPL" },
>     { "sport_id": 21, "sport_name": "T20" },
>     { "sport_id": 22, "sport_name": "Politics" },
>     { "sport_id": 23, "sport_name": "NBA Preseason" },
>     { "sport_id": 24, "sport_name": "NBA Playoffs" },
>     { "sport_id": 25, "sport_name": "NFL Preseason" },
>     { "sport_id": 26, "sport_name": "NFL Playoffs" },
>     { "sport_id": 27, "sport_name": "NHL Preseason" },
>     { "sport_id": 28, "sport_name": "NHL Playoffs" },
>     { "sport_id": 30, "sport_name": "MLB Spring Training" },
>     { "sport_id": 31, "sport_name": "MLB Playoffs" },
>     { "sport_id": 32, "sport_name": "NBA Summer League" },
>     { "sport_id": 33, "sport_name": "UEFA Europa League" },
>     { "sport_id": 34, "sport_name": "Liga MX" },
>     { "sport_id": 38, "sport_name": "ATP" },
>     { "sport_id": 39, "sport_name": "WTA" }
>   ]
> }
> ```

> [accordion] GET /api/v2/sports/\{sportID}/teams — Get teams
>
> Returns all teams for a given sport.
>
> ```bash theme={null}
> curl --fail-with-body -H "X-TheRundown-Key: $THERUNDOWN_API_KEY" "https://therundown.io/api/v2/sports/4/teams"
> ```
>
> ### Example Response
>
> ```json theme={null}
> {
>   "teams": [
>     {
>       "team_id": 1,
>       "name": "Boston",
>       "mascot": "Celtics",
>       "abbreviation": "BOS",
>       "record": "6-2",
>       "conference": {
>         "conference_id": 39,
>         "sport_id": 4,
>         "name": "Eastern Conference"
>       },
>       "division": {
>         "division_id": 15,
>         "conference_id": 39,
>         "sport_id": 4,
>         "name": "Atlantic"
>       }
>     },
>     {
>       "team_id": 23,
>       "name": "Los Angeles",
>       "mascot": "Lakers",
>       "abbreviation": "LAL",
>       "record": "7-2",
>       "conference": {
>         "conference_id": 757,
>         "sport_id": 4,
>         "name": "Western Conference"
>       },
>       "division": {
>         "division_id": 19,
>         "conference_id": 757,
>         "sport_id": 4,
>         "name": "Pacific"
>       }
>     },
>     {
>       "team_id": 21,
>       "name": "Golden State",
>       "mascot": "Warriors",
>       "abbreviation": "GS",
>       "record": "5-3",
>       "conference": {
>         "conference_id": 757,
>         "sport_id": 4,
>         "name": "Western Conference"
>       },
>       "division": {
>         "division_id": 19,
>         "conference_id": 757,
>         "sport_id": 4,
>         "name": "Pacific"
>       }
>     }
>   ]
> }
> ```

> [accordion] GET /api/v2/sports/\{sportID}/dates — Get available dates
>
> 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).
>
> ```bash theme={null}
> curl --fail-with-body -H "X-TheRundown-Key: $THERUNDOWN_API_KEY" "https://therundown.io/api/v2/sports/4/dates?offset=300"
> ```
>
> ### Example Response
>
> ```json theme={null}
> {
>   "dates": [
>     "2026-02-13T00:30:00+0000",
>     "2026-02-14T00:00:00+0000",
>     "2026-02-15T00:00:00+0000"
>   ]
> }
> ```
>
> 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.

> [accordion] GET /api/v2/sports/\{sportID}/divisions — Get divisions
>
> ```bash theme={null}
> curl --fail-with-body -H "X-TheRundown-Key: $THERUNDOWN_API_KEY" "https://therundown.io/api/v2/sports/2/divisions"
> ```
>
> ### Example Response
>
> ```json theme={null}
> {
>   "divisions": [
>     { "division_id": 1, "conference_id": 1, "sport_id": 2, "name": "NFC East" },
>     { "division_id": 2, "conference_id": 1, "sport_id": 2, "name": "NFC West" },
>     { "division_id": 3, "conference_id": 1, "sport_id": 2, "name": "NFC North" },
>     { "division_id": 4, "conference_id": 1, "sport_id": 2, "name": "NFC South" },
>     { "division_id": 5, "conference_id": 2, "sport_id": 2, "name": "AFC East" },
>     { "division_id": 6, "conference_id": 2, "sport_id": 2, "name": "AFC West" },
>     { "division_id": 7, "conference_id": 2, "sport_id": 2, "name": "AFC North" },
>     { "division_id": 8, "conference_id": 2, "sport_id": 2, "name": "AFC South" }
>   ]
> }
> ```

> [accordion] GET /api/v2/sports/\{sportID}/conferences — Get conferences
>
> ```bash theme={null}
> curl --fail-with-body -H "X-TheRundown-Key: $THERUNDOWN_API_KEY" "https://therundown.io/api/v2/sports/2/conferences"
> ```
>
> ### Example Response
>
> ```json theme={null}
> {
>   "conferences": [
>     { "conference_id": 1, "sport_id": 2, "name": "NFC" },
>     { "conference_id": 2, "sport_id": 2, "name": "AFC" }
>   ]
> }
> ```

***

## List All Sports

> [!NOTE]
>
> 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.

```bash cURL theme={null}
curl --fail-with-body "https://therundown.io/api/v2/sports"
```

```python Python theme={null}
import requests

response = requests.get("https://therundown.io/api/v2/sports", timeout=15)
response.raise_for_status()
for sport in response.json()["sports"]:
    print(f"{sport['sport_id']}: {sport['sport_name']}")
```

```javascript Node.js 22+ (server) theme={null}
const response = await fetch("https://therundown.io/api/v2/sports");
if (!response.ok) throw new Error(`Sports request failed: HTTP ${response.status}`);
const data = await response.json();
console.log(data.sports);
```

***

## Get Teams by Sport

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

### Parameters

| Parameter | Type | Required | Description |
| - | - | - | - |
| `sportID` | path | Yes | Sport ID (e.g., `4` for NBA) |

```bash cURL theme={null}
curl --fail-with-body -H "X-TheRundown-Key: $THERUNDOWN_API_KEY" "https://therundown.io/api/v2/sports/4/teams"
```

```bash cURL (Header Auth) theme={null}
curl --fail-with-body -H "X-TheRundown-Key: $THERUNDOWN_API_KEY" \
  "https://therundown.io/api/v2/sports/4/teams"
```

***

## Get Available Dates

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

### Parameters

| Parameter | Type | Required | Description |
| - | - | - | - |
| `sportID` | path | Yes | Sport ID |
| `offset` | query | No | UTC offset in **minutes**. US Central is `300` during daylight saving time (CDT) and `360` during standard time (CST). Shifts the date boundary. |
| `format` | query | No | `iso8601` (default) returns date strings, `epoch` returns Unix timestamps |

```bash theme={null}
curl --fail-with-body -H "X-TheRundown-Key: $THERUNDOWN_API_KEY" "https://therundown.io/api/v2/sports/4/dates?offset=300"
```

***

## Get Dates by Multiple Sport IDs

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

### Parameters

| Parameter | Type | Required | Description |
| - | - | - | - |
| `sport_ids` | query | Yes | Comma-separated sport IDs (e.g., `2,4,6`). Omitting it returns HTTP 400. |
| `offset` | query | No | UTC offset in **minutes**. US Central is `300` during daylight saving time (CDT) and `360` during standard time (CST). |

```bash theme={null}
curl --fail-with-body -H "X-TheRundown-Key: $THERUNDOWN_API_KEY" "https://therundown.io/api/v2/sports/dates?sport_ids=2,4,6&offset=300"
```

***

## 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.

```bash theme={null}
curl --fail-with-body -H "X-TheRundown-Key: $THERUNDOWN_API_KEY" "https://therundown.io/api/v2/sports/events/2026-02-26?sport_ids=2,4&offset=300"
```

***

## Get Divisions

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

```bash theme={null}
curl --fail-with-body -H "X-TheRundown-Key: $THERUNDOWN_API_KEY" "https://therundown.io/api/v2/sports/2/divisions"
```

***

## Get Conferences

Returns all conferences for a sport.

```bash theme={null}
curl --fail-with-body -H "X-TheRundown-Key: $THERUNDOWN_API_KEY" "https://therundown.io/api/v2/sports/2/conferences"
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.