Skip to main content
GET
Season Results

Season Results

Retrieve all completed match results for a specific competition season with standard page-based pagination.
Current Season OnlyDue to the API data provider limitations, this endpoint only supports the current season. Historical season data (past seasons) is not accessible through the match results API.
  • Current season requests → Returns paginated match results ✅
  • Historical season requests → Returns 422 error with explanation ❌
For historical data, the /standings endpoint provides final standings for previous seasons.

Endpoint

Parameters

Discovering Season Numbers

Before using this endpoint, discover available seasons using the standings endpoint:
The response includes a seasonFilters array:

Request Example

Response Structure

Response Fields

Complete Workflow: Fetch All Season Results

Multi-Season Historical Data

For analytics and prediction models requiring multiple seasons:

Error Handling

Rate Limiting Notes

  • Each call to /games/season-results counts as 1 API request towards your daily quota
  • The endpoint internally aggregates multiple internal calls, but you are only charged once
  • For large datasets, add delays between paginated requests to avoid hitting rate limits
  • A full Premier League season (380 games) requires 4 API calls at pageSize=100

Authorizations

x-api-key
string
header
required

Your SportsAPI Pro API key

Query Parameters

competitions
integer
required

Competition ID (e.g., 7 for Premier League)

Example:

7

seasonNum
integer
required

Season number from /standings?withSeasonsFilter=true (e.g., 129 for 2023/24)

Example:

129

page
integer
default:1

Page number (default: 1)

Example:

1

pageSize
integer
default:50

Results per page (default: 50, max: 100)

Required range: x <= 100
Example:

100

showOdds
boolean
default:false

Include betting odds data (default: false)

Response

Season results retrieved successfully

seasonNum
integer

The requested season number

seasonName
string

Human-readable season name (e.g., '2023/24')

competition
object

Competition metadata

pagination
object

Pagination information

games
object[]

List of completed match results

competitors
array

Team/competitor reference data

countries
array

Country reference data

Last modified on June 29, 2026