StatsHub Docs
Endpoint referenceWorld cup

/world-cup/referees

`scope` decides which fixtures count.

GET
/api/v2/world-cup/referees

scope decides which fixtures count. "career" is everything the official has refereed; "international" restricts to matches where both sides are national teams. The distinction is the point of the endpoint — a referee's domestic card rate is a poor guide to how they handle a World Cup tie, and the international sample is usually much smaller.

Every official on the roster is returned, including those with no matches recorded; their rates are null rather than zero.

Query Parameters

scope?string

Response Body

application/json

application/problem+json

application/problem+json

curl -X GET "https://example.com/api/v2/world-cup/referees"
{  "$schema": "https://example.com/schemas/WorldCupRefereesOKBody.json",  "data": [    {      "avgCardsPerGame": 0,      "avgFirstHalfCards": 0,      "avgFoulsPerGame": 0,      "avgPensPerGame": 0,      "avgRedsPerGame": 0,      "avgSecondHalfCards": 0,      "avgYellowsPerGame": 0,      "bothTeamsO15CardPct": 0,      "countrySlug": "string",      "games": 0,      "id": 0,      "name": "string",      "nextGame": {        "awayShort": "string",        "awayTeamId": 0,        "eventId": 0,        "homeShort": "string",        "homeTeamId": 0,        "internalId": 0,        "slug": "string",        "timestamp": 0,        "uniqueTournamentId": 0      },      "o35CardsPct": 0,      "o45CardsPct": 0,      "o55CardsPct": 0,      "redCards": 0,      "slug": "string",      "totalPenalties": 0,      "yellowCards": 0    }  ],  "scope": "string"}