Referee fixtures
GET
/
View as MarkdownTry in Playground →
Returns one page of matches the referee has officiated (recent) or has been assigned to (upcoming), 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. A referee who exists but has no appointments gets 200 with an empty array.
Parameters
idpathrequired
DataSportsAPI referee id, a positive integer
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
- type, page, count, hasNextPage; historyFrom is added if your plan excluded older fixtures
- errors
- 400
bad_request— type is neither recent nor upcoming, or page is not a whole number between 0 and 50
Any /v2 call can also come back with one of the common errors.
curl -H "Authorization: Bearer sk_live_…" \
"https://api.datasportsapi.com/v2/referees/{id}/fixtures"Example
{ "data": [ { "id": 201324, "status": { "type": "finished", … }, "referee": null, … }, … ],
"meta": { "type": "recent", "page": 0, "count": 30, "hasNextPage": true } }