Docs › Reference › Leagues › All leagues

GETAll leagues

Leagues available to the account, optionally filtered by country. Paginated, 100 items per page.

/v2.2/leagues/ with t=list

Try it in the interactive reference All Leagues operations

Request

GET /v2.2/leagues/?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": "6225",
      "name": "Oberliga NOFV",
      "is_cup": "0",
      "is_amateur": "1",
      "is_friendly": "0",
      "img": "https://cdn.soccersapi.com/images/soccer/leagues/100/6225.png",
      "id_current_season": "15860",
      "id_current_stage": null,
      "id_current_round": null,
      "continent": {
        "id": "2",
        "name": "Europe"
      },
      "country": {
        "id": "4",
        "name": "Germany",
        "cc": "de"
      },
      "seasons": []
    },
    {
      "id": "594",
      "name": "Bundesliga",
      "is_cup": "0",
      "is_amateur": "0",
      "is_friendly": "0",
      "img": "https://cdn.soccersapi.com/images/soccer/leagues/100/594.png",
      "id_current_season": "21268",
      "id_current_stage": "1",
      "id_current_round": "220932",
      "continent": {
        "id": "2",
        "name": "Europe"
      },
      "country": {
        "id": "4",
        "name": "Germany",
        "cc": "de"
      },
      "seasons": []
    }
  ],
  "meta": {
    "requests_left": 2950,
    "user": "your_username",
    "plan": "Soccer API 50",
    "page": 1,
    "pages": 1,
    "count": 40,
    "total": 40,
    "msg": ""
  }
}