Skip to content

Livematches in play

Demo: Matchboard, opens in a new tab
Docs v2

Venues

Venue

GET

/v2/venues/{id}

All plans

View as MarkdownTry in Playground →

One stadium or arena: its city, country, capacity, coordinates, a photo and home teams, plus per-sport totals over all matches the source holds there (match count, goals or points scored, home wins, draws).

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.

Parameters

id

pathrequired

DataSportsAPI venue id, a positive integer

Response

errors
404 not_found — DataSportsAPI has never assigned this id

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

curl -H "Authorization: Bearer sk_live_…" \
    "https://api.datasportsapi.com/v2/venues/{id}"
Example
{ "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": {} }