Referee
GET
/
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
idpathrequired
DataSportsAPI referee id, a positive integer
Response
- data
RefereeProfile- 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 } }