Docs › Reference › Players › All players

GETAll players

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

/v2.2/players/ with t=list

Try it in the interactive reference All Players operations

Request

GET /v2.2/players/?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": 195,
      "team_id": null,
      "national_team_id": null,
      "name": "Mart Ristl",
      "common_name": "Ristl, Mart",
      "position": "M",
      "firstname": "Mart",
      "lastname": "Ristl",
      "birthday": "1996-07-07",
      "birthcountry": null,
      "birthplace": null,
      "shirtnumber": null,
      "weight": 74,
      "height": 178,
      "age": 30,
      "foot": "right",
      "img": "https://cdn.soccersapi.com/images/soccer/players/50/195.png",
      "market_value": null,
      "country": {
        "id": 4,
        "name": "Germany",
        "cc": "de"
      }
    },
    {
      "id": 198,
      "team_id": null,
      "national_team_id": null,
      "name": "Dennis Jastrzembski",
      "common_name": "Jastrzembski, Dennis",
      "position": "F",
      "firstname": "Dennis",
      "lastname": "Jastrzembski",
      "birthday": "2000-02-20",
      "birthcountry": null,
      "birthplace": null,
      "shirtnumber": null,
      "weight": 77,
      "height": 176,
      "age": 26,
      "foot": null,
      "img": "https://cdn.soccersapi.com/images/soccer/players/50/198.png",
      "market_value": "$660000",
      "country": {
        "id": 4,
        "name": "Germany",
        "cc": "de"
      }
    }
  ],
  "meta": {
    "requests_left": 2950,
    "user": "your_username",
    "plan": "Soccer API 50",
    "page": 1,
    "pages": 100,
    "count": 100,
    "total": 9935,
    "msg": ""
  }
}