Seasons list

1. Endpoint
2. Parameters
3. Response

On this football API documentation page, we demonstrate how you can use our season API endpoint to get the list of seasons and access old competition data.

Accessing previous and future data for a competition is made easy via the use of seasons. While most of our football API endpoints by default use the current competition season, sometimes you might need to access previous or future data. For example, the group standings from last year. To know the ID of the season is of utmost importance in this case. This endpoint allows you to get to know the ID-s of the seasons.

live score API supports two kinds of seasons. The first is a whole year season, and the second is a split season. In the first case the season starts and ends in the same calendar year. While in the latter the season starts at some point during a year and ends the next calendar year. An example of a competition that runs throw a whole year season is the Allsvenskan (2021) which the UEFA Champions League runs during a split season (2021/2022)

ENDPOINT

The usage of this football API endpoint is as easy as it gets. There are no parameters required and the response contains a handful of fields.

PARAMETERS

RESPONSE

{
    "success": true,
    "data": {
        "seasons": [
            {
                "id": "12",
                "name": "2023",
                "start": "2023-01-01",
                "end": "2023-12-31"
            },
            {
                "id": "14",
                "name": "2022\/2023",
                "start": "2022-07-01",
                "end": "2023-06-30"
            },
            {
                "id": "11",
                "name": "2022",
                "start": "2022-01-01",
                "end": "2022-12-31"
            },
            {
                "id": "13",
                "name": "2021\/2022",
                "start": "2021-07-01",
                "end": "2022-06-30"
            }
        ]
    }
}