Skip to content

Livematches in play

Demo: Matchboard, opens in a new tab
Docs v2

Referees & managers

Referee fixtures

GET

/v2/referees/{id}/fixtures

All plans

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

id

pathrequired

DataSportsAPI referee id, a positive integer

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
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 } }