---
title: "Season Results"
method: GET
path: "/games/season-results"
tags: ["Games"]
---

# Season Results

`GET /games/season-results`

Get all match results for a specific competition and season with standard page-based pagination. Designed for bulk historical data ingestion and ETL pipelines.

## Query parameters

- `competitions` integer, required
- `seasonNum` integer, required
- `page` integer
- `pageSize` integer
- `showOdds` boolean

## Response `200`

Season results retrieved successfully

- object
  - `seasonNum` integer — The requested season number
  - `seasonName` string — Human-readable season name (e.g., '2023/24')
  - `competition` object — Competition metadata
    - `id` integer
    - `name` string
    - `countryId` integer
  - `pagination` object — Pagination information
    - `page` integer — Current page number
    - `pageSize` integer — Results per page
    - `totalGames` integer — Total games in the season
    - `totalPages` integer — Total pages available
    - `hasMore` boolean — Whether more pages exist
  - `games` object[] — List of completed match results
    - `id` integer — Game ID
    - `competitionId` integer
    - `seasonNum` integer
    - `startTime` string — ISO 8601 date/time
    - `statusGroup` integer — Status (4 = finished)
    - `homeCompetitor` object
      - `id` integer
      - `name` string
      - `score` integer
    - `awayCompetitor` object
      - `id` integer
      - `name` string
      - `score` integer
    - `winner` integer — 1 = home, 2 = away, 0 = draw
  - `competitors` unknown[] — Team/competitor reference data
    - unknown
  - `countries` unknown[] — Country reference data
    - unknown

## Other responses

- `400` — Missing required parameters: competitions and seasonNum

---

[API](https://skmtc.net/sportsapipro/apis/sportsapi-pro-football-api.md) · [All operations](https://skmtc.net/sportsapipro/apis/sportsapi-pro-football-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sportsapipro/sportsapi-pro-football-api/revisions/f56c5a94869d/schema)
