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

# SofaScore referee profile

`GET /sofascore/referee`

## Request

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

Returns a referee's profile: name, country, sport, career matches officiated and career yellow, red and yellow-red card totals, plus date of birth and first league debut when SofaScore records them. Get the referee id from the `referee.id` of the sofascore-event endpoint or from a sofascore-search result of type referee. Returns 404 for an unknown id.

## Query parameters

- `id` string, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- SofascoreRefereeResponseDoc
  - `code` integer
  - `data` SofascoreRefereeResponse
    - `fetched_at` string
    - `referee` SofascoreRefereeDetail
      - `country` string
      - `date_of_birth` string
      - `first_league_debut` string: FirstLeagueDebut is the date of the referee's first top-flight match when SofaScore records it.
      - `games` integer: Games, YellowCards, RedCards and YellowRedCards are career totals across every competition; each is omitted when SofaScore gives none.
      - `id` integer
      - `name` string
      - `red_cards` integer
      - `slug` string
      - `sport` string
      - `yellow_cards` integer
      - `yellow_red_cards` 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/afac9b012a27?raw)