Referee

GET

https://api.datasportsapi.com/v2/referees/{id}

Plan: All plans
Auth: Bearer dsa_live_…
Parameters: 1 required · 0 optional
Returns: RefereeProfile

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.

Worth knowing

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.

01Parameters

Name	In	Required	Description
`id`	path	Required	DataSportsAPI referee id, a positive integer

idpathRequired
DataSportsAPI referee id, a positive integer

02Request

The same call from the command line and each SDK. The SDK lines assume a client created with your key; left out, it is read from DATASPORTSAPI_API_KEY. Installing a client: SDKs & CLI.

curl -H "Authorization: Bearer dsa_live_…" \
    "https://api.datasportsapi.com/v2/referees/{id}"

03Response

The top-level keys of the JSON body. Each object links to its full shape in the data reference.

data: RefereeProfile
meta: competitionCount

ObjectsRefereeProfile

Example response

5 lines

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

04Errors

404not_found
DataSportsAPI has never assigned this id

Any key can also meet401unauthorized429rate_limited429quota_exceeded500internal_errorEvery error code