Skip to content

Livematches in play

Demo: Matchboard, opens in a new tab
Docs v2

Leagues

Season venues

GET

/v2/leagues/{id}/venues

All plans

View as MarkdownTry in Playground →

Lists every venue where matches of a league season are played. Available since 2026-11-04.

Venues come in the same shape fixtures use; fetch /v2/venues/{id} for the full profile. Because our data source leaves the country out of this list, we fill country from the venue data on fixtures and on /v2/venues/{id} (England is EN); it is null only when neither provides one. If the source has no venues for the season, the list is empty.

Parameters

id

pathrequired

league id issued by DataSportsAPI, a positive integer

season

queryrequired

season id, as listed by /v2/leagues/{id}/seasons

Response

data
Venue[]
meta
season, count
errors
403 history_not_in_plan — your plan’s history window begins after this season ended404 not_found — the season id does not belong to this league

Any /v2 call can also come back with one of the common errors.

curl -H "Authorization: Bearer sk_live_…" \
    "https://api.datasportsapi.com/v2/leagues/{id}/venues?season=…"
Example
{ "data": [ { "id": 200955, "name": "MKM Stadium", "city": "Hull", "country": null, "capacity": 25586 }, … ], "meta": { "season": 200386, "count": 20 } }