Skip to content

Livematches in play

Demo: Matchboard, opens in a new tab
Docs v2

Referees & managers

Referee

GET

/v2/referees/{id}

All plans

View as MarkdownTry in Playground →

Referee profile with country, sport, career totals (matches plus yellow, red and second-yellow cards) and a per-competition breakdown of appearances, cards and penalties awarded.

Career totals come straight from the source. competitions covers every competition the referee has officiated in, or is [] if the source lists none. Figures are not broken down by season, because the source has no such split.

Parameters

id

pathrequired

DataSportsAPI referee id, a positive integer

Response

meta
competitionCount
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/referees/{id}"
Example
{ "data": { "id": 51040, "name": "Thomas Bramall", "slug": "thomas-bramall", "country": { "code": "EN", "name": "England" },
    "games": 197, "yellowCards": 667, "redCards": 15, "yellowRedCards": 10, "image": "https://cdn.datasportsapi.com/v2/referees/51040/photo", "sport": "football",
    "competitions": [ { "league": { "id": 195828, "name": "Premier League", … }, "appearances": 57, "yellowCards": 229,
                        "redCards": 6, "yellowRedCards": 4, "penalties": 17 }, … ] },
  "meta": { "competitionCount": 7 } }