Season Venues

get

https://api.sportradar.com/soccer/{access_level}/v4/{language_code}/seasons/{season_id}/venues.{format}

Provides a list of venues associated with a given season.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

⏱️
Update Frequency
300s Time To Live / Cache

Data Points

Venue

Attribute	Parent Element	Type	Description
`capacity`	`venue`	Integer	Capacity of a venue ex. `60000`
`city_id`	`venue`	String	Unique ID of a city ex. `sr:city:59`
`city_name`	`venue`	String	City name of a venue ex. `Liverpool`
`country_code`	`venue`	String	Country code of a venue ex. `ENG` (England)
`country_name`	`venue`	String	Country name of a venue ex. `England`
`id`	`venue`	String	Unique ID of a venue ex. `sr:venue:579`
`long_name`	`venue`	String	Extended name for a venue, when one exists ex. `Sultan Qaboos Sports Complex - Muscat`
`map_coordinates`	`venue`	String	Coordinates of a venue ex. `53.430622,-2.960919`
`name`	`venue`	String	Name of a venue ex. `Sultan Qaboos Sports Complex`
`timezone`	`venue`	String	Timezone of a venue ex. `Europe/London`

Path Params

access_level

string

enum

required

Defaults to trial

The access level of your API key

trial, production

Allowed:

language_code

string

enum

required

Defaults to en

2-letter code for supported languages

da (Danish), de (German), el (Greek), en (English), es (Spanish), fi (Finnish), fr (French), id (Indonesian), it (Italian), ja (Japanese), nl (Dutch), pt (Portuguese), ru (Russian), sr (Serbian), srl (Serbian Latin), th (Thai), tr (Turkish), zh (Chinese - simplified), zht (Chinese - traditional)

The above codes are the fully supported languages for this API. Click here for valid language codes and a tabular list of available languages per competition.

season_id

string

required

Defaults to sr:season:144602

Unique Id of a season, found in the Seasons endpoint

Note: The API provides a maximum of 3 seasons per competition — 2 previous seasons and 1 current season.

Example: sr:season:118689

format

string

enum

required

Defaults to json

Format returned

json, xml

Allowed:

Query Params

start

int32

The number of items to skip before starting to collect the result set.
Default: 0

Example: start=1000 to receive a 2nd page of results (if necessary)

Note: You may alternatively use offset

limit

int32

The number of items to return.
Maximum: 1000
Default value: 1000

Example: limit=5

Note: Pagination may be required to pull all data within this feed. By default, the feed will return 1,000 sport events.

Response

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

Update Frequency

Data Points

200