Season detail
A
GET
/v1/leagues/{id}/seasons/{season}
One league-season, its clubs and dates
One season of one competition: its date range, clubs, match count and per-field coverage.
Plan
This endpoint needs Archive.
Calling it on a lower plan returns a 403 naming the plan it needs and
a link to pricing, never a bare refusal.
Parameters
league_id
string
path
required
The competition id. e.g.
lg_24T9Z0G
season
integer
path
required
Season by starting year. e.g.
2024
Returns
data.league_id
string
Our id for the competition.
data.country_name
string
The country the competition belongs to.
data.league_name
string
The competition's name.
data.match_count
integer
Match count.
data.priced_count
integer
Priced count.
data.season_first
integer
Season first.
data.season_last
integer
Season last.
data.coverage
object
Coverage.
data.coverage.home_kickoff_price
number
The price for a home win at kickoff, as decimal odds.
meta.data_as_of
string
When the data behind this answer was last brought up to date.
meta.request_id
string
This request's id, to quote to support.
Request
curl "https://api.footballsoccerapi.com/v1/leagues/lg_24T9Z0G/seasons/2024" \ -H "X-API-Key: $FSAPI_KEY"
const res = await fetch("https://api.footballsoccerapi.com/v1/leagues/lg_24T9Z0G/seasons/2024", { headers: { "X-API-Key": process.env.FSAPI_KEY } }); const { data, meta } = await res.json();
import os, requests r = requests.get( "https://api.footballsoccerapi.com/v1/leagues/lg_24T9Z0G/seasons/2024", headers={"X-API-Key": os.environ["FSAPI_KEY"]}, ) data = r.json()["data"]
$ch = curl_init("https://api.footballsoccerapi.com/v1/leagues/lg_24T9Z0G/seasons/2024"); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ["X-API-Key: {$key}"], ]); $data = json_decode(curl_exec($ch), true)["data"];
Example response
A real row from the archive, fetched when this page rendered. Run it against your own key below.
200 OK
application/json
{
"data": {
"league_id": "lg_2DGPHND",
"country_name": "World",
"league_name": "Friendlies Clubs",
"match_count": 45509,
"priced_count": 13262,
"season_first": 2020,
"season_last": 2026,
"coverage": {
"home_kickoff_price": 29.1
}
},
"meta": {
"data_as_of": "2026-10-29T04:32:57Z",
"request_id": "01J9QW3C7M4KX2VB"
}
}
Run it live
Paste your key and fire the real request. The key is kept in this browser only and never sent anywhere but the API.