Docs › Reference › Referees › All referees

GETAll referees

All referees, or the referees of a country. Paginated, 100 items per page.

/v2.2/referees/ with t=list

Try it in the interactive reference All Referees operations

Request

GET /v2.2/referees/?user=USER&token=TOKEN&t=list&country_id=4

Paginated: 100 items per page; read meta.pages and request the next pages with page.
Every request needs the user and token query parameters of the account.

Parameters

Name	Required	Description	Example
`country_id`	no	Country ID.	`4`
`page`	no	Page number on paginated operations, starting at 1. The response reports `meta.page` and `meta.pages`; a page beyond the last returns an empty `data`.	`1`

Example response

{
  "data": [
    {
      "id": 22,
      "name": "Harm Osmers",
      "common_name": "Osmers",
      "firstname": "Harm",
      "lastname": "Osmers",
      "birthday": "1985-01-28",
      "img": "https://cdn.soccersapi.com/images/soccer/referees/50/22.png",
      "country": {
        "id": 4,
        "name": "Germany",
        "cc": "de"
      }
    },
    {
      "id": 23,
      "name": "Patrick Ittrich",
      "common_name": "Ittrich",
      "firstname": "Patrick",
      "lastname": "Ittrich",
      "birthday": "1979-01-03",
      "img": "https://cdn.soccersapi.com/images/soccer/referees/50/23.png",
      "country": {
        "id": 4,
        "name": "Germany",
        "cc": "de"
      }
    }
  ],
  "meta": {
    "requests_left": 2950,
    "user": "your_username",
    "plan": "Soccer API 50",
    "page": 1,
    "pages": 4,
    "count": 100,
    "total": 343,
    "msg": ""
  }
}