Seasons By League
This endpoint allows you to retrieve the seasons from a specific league.
Multi-language: This feature allows the user to manually change the language of the API response by adding value to the
langattribute. Example:lang=en.
Pagination: The endpoint uses an offset and limit system. Specify the offset and limit parameters to fetch the desired range of results. The maximum and default number of results per request is 50.
Update Period: The endpoint is updated every day.
Recommended Calls: Limit calls to 1 per day.
Use Cases
Get seasons from a specific league_idhttps://football.sportmicro.com/seasons-by-league?league_id=eq.{league_id}
Query Parameters
- league_id integer
The id of the league
Example: eq.1 - offset string
Default value:
0Limiting and Pagination
Example: 0 - limit string
Default value:
50Limiting and Pagination
Example: 50 - lang string
Default value:
enMulti-language
Example: en
- 200
OK
- application/json
- Schema
- Example (from schema)
Schema array
- league_id integer
The id of the league
Note: This is a Foreign Key to
leagues.id. - league_name text
The name of the league
- league_hash_image text
The hash image of the league
- seasons jsonb
The seasons
[
{
"league_id": 1,
"league_name": "Premier League",
"league_hash_image": "69a3f23712e51ed08e223d7d438c358acea5b8eac0b75cb1526589024fcd255b",
"seasons": [
{
"id": 3177,
"name": "Premier League 25/26",
"year": "25/26",
"start_time": "2025-08-15"
},
{
"id": 3380,
"name": "Premier League 24/25",
"year": "24/25",
"start_time": "2024-08-16"
},
{
"id": 5276,
"name": "Premier League 23/24",
"year": "23/24",
"start_time": "2023-08-11"
},
{
"id": 8105,
"name": "Premier League 99/00",
"year": "99/00",
"start_time": "1999-08-07"
},
{
"id": 8342,
"name": "Premier League 13/14",
"year": "13/14",
"start_time": "2013-08-18"
},
{
"id": 8377,
"name": "Premier League 20/21",
"year": "20/21",
"start_time": "2020-09-12"
},
{
"id": 8560,
"name": "Premier League 18/19",
"year": "18/19",
"start_time": "2018-08-10"
},
{
"id": 8602,
"name": "Premier League 22/23",
"year": "22/23",
"start_time": "2022-08-05"
},
{
"id": 8795,
"name": "Premier League 21/22",
"year": "21/22",
"start_time": "2021-08-13"
},
{
"id": 9122,
"name": "Premier League 19/20",
"year": "19/20",
"start_time": "2019-08-10"
},
{
"id": 9430,
"name": "Premier League 17/18",
"year": "17/18",
"start_time": "2017-08-11"
},
{
"id": 9654,
"name": "Premier League 16/17",
"year": "16/17",
"start_time": "2016-08-13"
},
{
"id": 11534,
"name": "Premier League 15/16",
"year": "15/16",
"start_time": "2015-08-08"
},
{
"id": 11540,
"name": "Premier League 14/15",
"year": "14/15",
"start_time": "2014-08-16"
},
{
"id": 17056,
"name": "Premier League 06/07",
"year": "06/07",
"start_time": "2006-08-19"
},
{
"id": 35755,
"name": "Premier League 07/08",
"year": "07/08",
"start_time": "2007-08-11"
},
{
"id": 41755,
"name": "Premier League 11/12",
"year": "11/12",
"start_time": "2011-08-13"
},
{
"id": 42531,
"name": "Premier League 09/10",
"year": "09/10",
"start_time": "2009-08-15"
},
{
"id": 59314,
"name": "Premier League 12/13",
"year": "12/13",
"start_time": "2012-08-18"
},
{
"id": 60415,
"name": "Premier League 05/06",
"year": "05/06",
"start_time": "2005-08-13"
},
{
"id": 60618,
"name": "Premier League 10/11",
"year": "10/11",
"start_time": "2010-08-14"
},
{
"id": 60764,
"name": "Premier League 04/05",
"year": "04/05",
"start_time": "2004-08-14"
},
{
"id": 61107,
"name": "Premier League 08/09",
"year": "08/09",
"start_time": "2008-08-16"
},
{
"id": 62669,
"name": "Premier League 98/99",
"year": "98/99",
"start_time": "1998-08-15"
},
{
"id": 62671,
"name": "Premier League 96/97",
"year": "96/97",
"start_time": "1996-08-17"
},
{
"id": 62676,
"name": "Premier League 95/96",
"year": "95/96",
"start_time": "1995-08-19"
},
{
"id": 62679,
"name": "Premier League 94/95",
"year": "94/95",
"start_time": "1994-08-20"
},
{
"id": 62681,
"name": "Premier League 92/93",
"year": "92/93",
"start_time": "1992-08-15"
},
{
"id": 63044,
"name": "Premier League 03/04",
"year": "03/04",
"start_time": "2003-08-16"
},
{
"id": 63050,
"name": "Premier League 02/03",
"year": "02/03",
"start_time": "2002-08-17"
},
{
"id": 63059,
"name": "Premier League 01/02",
"year": "01/02",
"start_time": "2001-08-18"
},
{
"id": 63066,
"name": "Premier League 97/98",
"year": "97/98",
"start_time": "1997-08-09"
},
{
"id": 63074,
"name": "Premier League 93/94",
"year": "93/94",
"start_time": "1993-08-14"
},
{
"id": 63542,
"name": "Premier League 00/01",
"year": "00/01",
"start_time": "2000-08-19"
}
]
}
]