Docs menu

SofaScore API endpoint

SofaScore referee profile API

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.

GETapiKey1 credit/requestSofaScoresofascore.refereeResponseDoc/sofascore/referee

Endpoint facts

Method: GET
API path: /sofascore/referee
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: SofaScore
Response schema: #/definitions/sofascore.refereeResponseDoc

SofaScore API Try SofaScore referee profile API in Playground SofaScore API documentation

How this endpoint behaves

Query parameters:

id: required. Numeric SofaScore referee id, e.g. 74264. Get it from the referee.id of sofascore-event or from a sofascore-search result of type referee.

Notable response behavior:

games, yellow_cards, red_cards and yellow_red_cards are career totals across every competition; each is omitted when SofaScore gives none (a real 0 is kept). date_of_birth and first_league_debut appear only when SofaScore records them.
Returns 404 for an unknown id. Per-competition numbers are in sofascore-referee-statistics; the matches are in sofascore-referee-events.

Live monitoring

Monitored request: GET /sofascore/referee?id=74264
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 0.82 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /sofascore/referee?id=74264
Fields returned with a value: 9

Field	In the sample	Value in the sample
referee.id	Has a value
referee.name	Has a value	“Robert Jones”
referee.slug	Has a value
referee.country	Has a value	“England”
referee.sport	Has a value	“football”
referee.games	Has a value	321
referee.yellow_cards	Has a value	1,156
referee.red_cards	Has a value	20
referee.yellow_red_cards	Has a value	13

Request parameters

Parameter	Type	Required	Default	Description	Example
id	string	Yes		Numeric SofaScore referee id	74264
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/sofascore/referee?id=74264" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "source_url": "https://api.sofascore.com/api/v1/referee/69853",
    "fetched_at": "2026-10-07T00:00:00Z",
    "referee": {
      "id": 69853,
      "name": "Anthony Taylor",
      "slug": "taylor-anthony",
      "country": "England",
      "sport": "football",
      "games": 658,
      "yellow_cards": 2490,
      "red_cards": 68,
      "yellow_red_cards": 49,
      "date_of_birth": "1978-10-20",
      "first_league_debut": "2010-02-03"
    }
  }
}

Request schema

No body schema

Response schema

#/definitions/sofascore.refereeResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	sofascore.RefereeResponse	No
data.fetched_at	string	No
data.referee	sofascore.RefereeDetail	No
data.referee.country	string	No	England
data.referee.date_of_birth	string	No	1979-06-20
data.referee.first_league_debut	string	No	2010-02-03	FirstLeagueDebut is the date of the referee's first top-flight match when SofaScore records it.
data.referee.games	integer	No	321	Games, YellowCards, RedCards and YellowRedCards are career totals across every competition; each is omitted when SofaScore gives none.
data.referee.id	integer	No	74264
data.referee.name	string	No	Robert Jones
data.referee.red_cards	integer	No	20
data.referee.slug	string	No	robert-jones
data.referee.sport	string	No	football
data.referee.yellow_cards	integer	No	1156
data.referee.yellow_red_cards	integer	No	13
data.source_url	string	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/sofascore/referee?id=74264" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More SofaScore endpoint docs SofaScore API SofaScore categories for a sport API documentation SofaScore competitions in a category API documentation SofaScore league draft picks API documentation SofaScore league draft API documentation SofaScore esports game detail API documentation SofaScore event at-bat pitches API documentation

Open in Playground Back to group

Docs menu

SofaScore API endpoint

SofaScore referee profile API

GETapiKey1 credit/requestSofaScoresofascore.refereeResponseDoc/sofascore/referee

Endpoint facts

Method: GET
API path: /sofascore/referee
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: SofaScore
Response schema: #/definitions/sofascore.refereeResponseDoc

SofaScore API Try SofaScore referee profile API in Playground SofaScore API documentation

How this endpoint behaves

Query parameters:

id: required. Numeric SofaScore referee id, e.g. 74264. Get it from the referee.id of sofascore-event or from a sofascore-search result of type referee.

Notable response behavior:

games, yellow_cards, red_cards and yellow_red_cards are career totals across every competition; each is omitted when SofaScore gives none (a real 0 is kept). date_of_birth and first_league_debut appear only when SofaScore records them.
Returns 404 for an unknown id. Per-competition numbers are in sofascore-referee-statistics; the matches are in sofascore-referee-events.

Live monitoring

Monitored request: GET /sofascore/referee?id=74264
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 0.82 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /sofascore/referee?id=74264
Fields returned with a value: 9

Field	In the sample	Value in the sample
referee.id	Has a value
referee.name	Has a value	“Robert Jones”
referee.slug	Has a value
referee.country	Has a value	“England”
referee.sport	Has a value	“football”
referee.games	Has a value	321
referee.yellow_cards	Has a value	1,156
referee.red_cards	Has a value	20
referee.yellow_red_cards	Has a value	13

Request parameters

Parameter	Type	Required	Default	Description	Example
id	string	Yes		Numeric SofaScore referee id	74264
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/sofascore/referee?id=74264" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "source_url": "https://api.sofascore.com/api/v1/referee/69853",
    "fetched_at": "2026-10-07T00:00:00Z",
    "referee": {
      "id": 69853,
      "name": "Anthony Taylor",
      "slug": "taylor-anthony",
      "country": "England",
      "sport": "football",
      "games": 658,
      "yellow_cards": 2490,
      "red_cards": 68,
      "yellow_red_cards": 49,
      "date_of_birth": "1978-10-20",
      "first_league_debut": "2010-02-03"
    }
  }
}

Request schema

No body schema

Response schema

#/definitions/sofascore.refereeResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	sofascore.RefereeResponse	No
data.fetched_at	string	No
data.referee	sofascore.RefereeDetail	No
data.referee.country	string	No	England
data.referee.date_of_birth	string	No	1979-06-20
data.referee.first_league_debut	string	No	2010-02-03	FirstLeagueDebut is the date of the referee's first top-flight match when SofaScore records it.
data.referee.games	integer	No	321	Games, YellowCards, RedCards and YellowRedCards are career totals across every competition; each is omitted when SofaScore gives none.
data.referee.id	integer	No	74264
data.referee.name	string	No	Robert Jones
data.referee.red_cards	integer	No	20
data.referee.slug	string	No	robert-jones
data.referee.sport	string	No	football
data.referee.yellow_cards	integer	No	1156
data.referee.yellow_red_cards	integer	No	13
data.source_url	string	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/sofascore/referee?id=74264" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

SofaScore referee profile API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

SofaScore referee profile API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related