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 referenceAll Leagues operations
Request
GET /v2.2/leagues/?api_key=API_KEY&t=list&country_id=4
- Paginated: 100 items per page; read
meta.pages and request the next pages with page. - Available on every plan for the leagues the plan covers.
- Authenticate with
api_key=API_KEY in the URL, or Authorization: Bearer API_KEY as an alternative. Both use the same key, without a username. See authentication methods.
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": ""
}
}
