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.

Our seasons' ID-s are persistent and will not change over time!

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.


GET:

PARAMETERS


This football API endpoint does not need or accept parameters

RESPONSE


NameTypeExampleDescription
enddate2022-12-31A rough end date of the season. May vary from a competition to competition
idnumber1The id of the season can be used as a parameter on other football API endpoints.
namestring2018/2019A human readable label of the season.
startdate2022-01-01A rough start date of the season. May vary from a competition to competition

{
    "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"
            }
        ]
    }
}


Didn't find what you need?

Do no hesitate to contact us. We will get back to you as soon as possible.