---
title: "Get event schedule for a sport"
method: GET
path: "/api/v1/sports/{sportID}/schedule"
tags: ["V1 Sports"]
---

# Get event schedule for a sport

`GET /api/v1/sports/{sportID}/schedule`

## Request

- Base URL: `https://therundown.io`
- URL: `https://therundown.io/api/v1/sports/{sportID}/schedule`
- Auth: API key in header `X-TheRundown-Key`

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.

## Path parameters

- `sportID` integer, required

## Query parameters

- `limit` integer
- `season_year` integer
- `season_type_id` integer
- `from` string, date
- `team_id` integer
- `last_event_uuid` string
- `sort` 'asc' | 'desc'
- `conference_id` integer
- `division_id` integer
- `include_teams` string

## Response `200`

Schedule

- ScheduleResponse
  - `schedules` ScheduledEvent[]
    - `event_id` string
    - `event_uuid` string
    - `sport_id` integer
    - `season_type` string
    - `season_year` integer
    - `away_team` string
    - `home_team` string
    - `date_event` string, date-time
    - `neutral_site` boolean, nullable
    - `conference_competition` boolean, nullable
    - `conference_id` integer
    - `conference_name` string
    - `league_name` string, nullable
    - `league_id` integer
    - `event_name` string, nullable
    - `game_number` 1 | 2: Game number for a true MLB doubleheader. Omitted for ordinary and standalone makeup games.
    - `game_type` 'doubleheader' | 'makeup' | 'doubleheader_makeup': Structured MLB doubleheader or makeup classification. Omitted for ordinary games.
    - `broadcast` string, nullable
    - `event_location` string, nullable
    - `attendance` integer, nullable
    - `status` string
    - `status_detail` string
    - `away_score` integer, nullable
    - `home_score` integer, nullable

## Changes

- **2026-08-05** `f069d4e82f52`: 2 info
  - added the optional property `schedules/items/game_number` to the response with the `200` status
  - added the optional property `schedules/items/game_type` to the response with the `200` status

[Operation history](https://skmtc.dev/therundown/apis/therundown-sports-api/changes/api/v1/sports/:sportID/schedule/get.md)

---

[API](https://skmtc.dev/therundown/apis/therundown-sports-api.md) - [All operations](https://skmtc.dev/therundown/apis/therundown-sports-api/llms.txt) - [OpenAPI document](https://skmtc.dev/therundown/apis/therundown-sports-api/revisions/b1735c57a340?raw)