Venue

GET

https://api.datasportsapi.com/v2/venues/{id}

Plan: All plans
Auth: Bearer dsa_live_…
Parameters: 1 required · 0 optional
Returns: VenueProfile

Everything about one stadium or arena: where it is (city, country, coordinates), how many it holds, a photo, and which teams play their home games there. For each sport it also sums up every match the source has recorded at the venue — match count, home wins, draws, and goals or points scored.

Worth knowing

sports is ordered by matches played, and its slugs are the values /v2/venues/{id}/fixtures accepts. latitude / longitude are null if the source has no coordinates.

01Parameters

Name	In	Required	Description
`id`	path	Required	DataSportsAPI venue id, a positive integer

idpathRequired
DataSportsAPI venue id, a positive integer

02Request

The same call from the command line and each SDK. The SDK lines assume a client created with your key; left out, it is read from DATASPORTSAPI_API_KEY. Installing a client: SDKs & CLI.

curl -H "Authorization: Bearer dsa_live_…" \
    "https://api.datasportsapi.com/v2/venues/{id}"

03Response

The top-level keys of the JSON body. Each object links to its full shape in the data reference.

data: VenueProfile

ObjectsVenueProfile

Example response

7 lines

{ "data": { "id": 812, "name": "Emirates Stadium", "slug": "emirates-stadium", "city": "London",
    "country": { "code": "EN", "name": "England", "flag": "https://cdn.datasportsapi.com/v2/countries/EN/flag" },
    "capacity": 60704, "latitude": 51.55504, "longitude": -0.1084, "image": "https://cdn.datasportsapi.com/v2/venues/812/photo",
    "teams": [ { "id": 42, "name": "Arsenal", … } ],
    "sports": [ { "sport": "football", "matchCount": 419, "scored": 1297, "homeWinPercentage": 68.26, "drawPercentage": 16.23 },
                { "sport": "rugby", "matchCount": 1, "scored": 53, "homeWinPercentage": 0, "drawPercentage": 0 } ] },
  "meta": {} }

04Errors

404not_found
DataSportsAPI has never assigned this id

Any key can also meet401unauthorized429rate_limited429quota_exceeded500internal_errorEvery error code