---
title: "Get Schedule"
method: GET
path: "/api/v1/games/schedule"
tags: ["Games"]
---

# Get Schedule

`GET /api/v1/games/schedule`

Get the game schedule with optional filtering and pagination.

Args:
    season: Filter by season (e.g., "2024-25")
    season_type: Filter by season type (e.g., "regular", "playoff")
    limit: Maximum number of results to return (default: 100, max: 1000)
    offset: Number of results to skip for pagination (default: 0)

Returns:
    Dictionary containing:
    - data: List of game schedule items
    - pagination: Pagination metadata (limit, offset, count, total)

## Query parameters

- `season` string, nullable
- `competition_id` string, nullable
- `season_type` string, nullable
- `limit` integer
- `offset` integer

## Headers

- `x-api-key` string, nullable
- `League` string, nullable

## Response `200`

Successful Response

- GameScheduleResponse
  - `data` GameScheduleItem[], required
    - `season` string, required
    - `competition_id` string, nullable
    - `season_type` string, required
    - `game_id` string, required
    - `game_game_id` string, nullable
    - `home_team_id` string, nullable
    - `home_team_alias` string, nullable
    - `away_team_id` string, nullable
    - `away_team_alias` string, nullable
    - `scheduled_date_time` string, date-time, required
    - `venue` string, nullable
    - `game_status` string, required
  - `pagination` PaginationMetadata, required
    - `limit` integer, required
    - `offset` integer, required
    - `count` integer, required
    - `total` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/preciser/apis/preciser-data-management-api.md) · [All operations](https://skmtc.net/preciser/apis/preciser-data-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/preciser/preciser-data-management-api/revisions/64853d21435b/schema)