---
title: "SofaScore referee card statistics"
method: GET
path: "/sofascore/referee-statistics"
tags: ["SofaScore"]
---

# SofaScore referee card statistics

`GET /sofascore/referee-statistics`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/sofascore/referee-statistics`
- Auth: API key in header `x-api-key`

Returns a referee's record per competition: matches officiated, yellow cards, red cards, yellow-red cards and penalties awarded. The per-competition appearances add up to the career matches in sofascore-referee. An empty `competitions` list is valid for a referee with no recorded competitions.

## Query parameters

- `id` string, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- SofascoreRefereeStatisticsResponseDoc
  - `code` integer
  - `data` SofascoreRefereeStatisticsResponse
    - `competitions` SofascoreRefereeCompetitionStatistics[]
      - `appearances` integer
      - `competition` SofascoreUniqueTournamentBrief
        - `category` string
        - `gender` string
        - `id` integer
        - `name` string
        - `slug` string
        - `sport` string
      - `penalties` integer
      - `red_cards` integer
      - `yellow_cards` integer
      - `yellow_red_cards` integer
    - `count` integer
    - `fetched_at` string
    - `referee_id` integer
    - `source_url` string
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/028417aa35bb?raw)