FOOTBALL REFEREE STATISTICS API

Referee stats

Complimentary key

Results and cards by referee, by competition and season. On the complimentary key it reads this season's Premier League.

GET/v1/stats/referees

TRY ITComplimentary

X-API-Key

Kept in this browser for every docs page. No key yet? Get a free key

competition

season

GET https://api.footballapi.org/v1/stats/referees?competition=premier-league&season=2026

The answer appears below, with its status and time.

curl "https://api.footballapi.org/v1/stats/referees?competition=premier-league&season=2026" \
  -H "X-API-Key: your key"

PARAMETERS

competitionstringA competition from /v1/competitions, such as premier-league. Leave it out for every competition your key reads.

seasonintegerThe first year of the season: 2026 for 2026/27.From 2015, or the competition's first season

No match was in play when the example below was taken, so its list is empty. The fields are listed here from the first example taken during a match.

200GET /v1/stats/referees?competition=premier-league&season=2026, taken 21 Oct 2026, while nothing was in play

{
  "data": [],
  "meta": {
    "count": 0,
    "request_id": "req_5b05151fa528a052"
  }
}

401unauthorizedNo key, or a key we do not know.

400bad_requestA parameter is missing or not in the right form; the message names it.

403upgrade_requiredAnything outside this season's Premier League, on the complimentary key.

404not_foundAn id or competition we do not have.

422unknown_parameterA parameter this endpoint does not take.

429quota_exceededThe day's 50 calls are used, on the complimentary key; they reset at 00:00 UTC.