Venue fixtures
GET
/
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
idpathrequired
DataSportsAPI venue id, a positive integer
sportquery
sport slug taken from VenueProfile.sports; when omitted, the sport played most often at the venue
typequery
recent | upcoming; upcoming when omitted
pagequery
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 } }