Skip to content

Livematches in play

Demo: Matchboard, opens in a new tab
Docs v2

Venues

Venue fixtures

GET

/v2/venues/{id}/fixtures

All plans

View as MarkdownTry in Playground →

Returns one page of past or scheduled matches at a venue in a single sport, split by the same rule as team fixtures.

upcoming covers matches yet to start, soonest first; recent covers live, finished and called-off matches, newest first. If the venue has no matches in that sport, the response is 200 with an empty array.

Parameters

id

pathrequired

DataSportsAPI venue id, a positive integer

sport

query

sport slug taken from VenueProfile.sports; when omitted, the sport played most often at the venue

type

query

recent | upcoming; upcoming when omitted

page

query

zero-based page number, a whole number from 0 to 50 (defaults to 0)

Response

data
Fixture[]
meta
sport, type, page, count, hasNextPage; historyFrom is added if your plan excluded older fixtures
errors
400 bad_request — type is neither recent nor upcoming, page is not a whole number between 0 and 50, or sport is not recognised

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}/fixtures"
Example
{ "data": [ { "id": 701233, "status": { "type": "finished", … }, "home": { "name": "Arsenal", … }, "away": { "name": "Everton", … }, … }, … ],
  "meta": { "sport": "football", "type": "recent", "page": 0, "count": 30, "hasNextPage": true } }