Search K

Appearance

Get venues ​

GET
/v1/venues

Get venues

Authorizations​

api_key
TypeAPI Key (header: X-Api-Key)

Parameters​

Query Parameters

sorting
Typestring
Defaultnull
page_size

Number of items per page

Typeinteger
Default50
page

Current page

Typeinteger
Default1
country

Country in iso format

Typestring
Example"GBR"
venue_type

Enum: racetrack, stadium, other

Typestring
Example"stadium"
popular

Search for popular stadiums

Typeboolean
Exampletrue
venue_name

Venue name

Typestring
Example"Anfield"
city

Search by city name

Typestring
Example"Liverpool"
slug

Seo friendly alternative to uuid

Typestring
Example"anfield"
venue_id

Filter on venue ID

Typestring
Example"7d881550d5ba4cb2b3faca11a9b1695d_vnx"

Responses​

OK

application/json
JSON
{
"venues": [
{
"venue_id": "7d881550d5ba4cb2b3faca11a9b1695d_vnx",
"official_name": "Anfield",
"country": "GBR",
"popular_stadium": true,
"venue_type": "stadium",
"capacity": 53394,
"city": "Liverpool",
"latitude": "53.430819",
"longitude": "-2.960827",
"number": "1",
"postalcode": "L4 0TH",
"streetname": "Anfield Road",
"opened": 1892,
"track_length": 4000,
"wikipedia_slug": "Anfield",
"wikipedia_snippet": "Anfield is a football stadium in Anfield, Liverpool, Merseyside, England...",
"slug": "anfield"
}
],
"pagination": {
"total_size": 1,
"page_size": 50,
"next_page": "string",
"previous_page": "string"
}
}

Playground​

Server
Authorization
Variables
Key
Value

Samples​