The API uses environment variables to launch API calls: {{USERNAME}} and {{TOKEN}}. You can set them from TRY IT OUT
League by ID
GET
/v2.2/leagues/
id.It returns the league’s name, country, current season, and other useful metadata.
league_id (from a fixture, team, or search query) and want to confirm details or display them in your app.Typical Use Cases
league_id before using it in fixtures, standings, or live scores requests.id=1004 returns details for the Austria Bundesliga.Example Request
Request
Query Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request GET '/v2.2/leagues/?user={{USERNAME}}&token={{TOKEN}}&t=info&id=1005'Response Response Example
{
"data": {
"id": 1005,
"name": "Bundesliga",
"is_cup": "0",
"is_amateur": "0",
"is_friendly": "0",
"img": "https://cdn.soccersapi.com/images/soccer/leagues/100/1005.png",
"id_current_season": "15287",
"id_current_stage": "1",
"id_current_round": "198799",
"continent": {
"id": 2,
"name": "Europe"
},
"country": {
"id": 15,
"name": "Austria",
"cc": "at"
},
"seasons": [
{
"id": "15287",
"name": "25/26",
"is_current": "1"
},
{
"id": "14418",
"name": "24/25",
"is_current": "0"
},
{
"id": "13449",
"name": "23/24",
"is_current": "0"
},
{
"id": "12588",
"name": "22/23",
"is_current": "0"
},
{
"id": "10512",
"name": "21/22",
"is_current": "0"
},
{
"id": "7227",
"name": "20/21",
"is_current": "0"
},
{
"id": "640",
"name": "19/20",
"is_current": "0"
},
{
"id": "641",
"name": "18/19",
"is_current": "0"
},
{
"id": "642",
"name": "17/18",
"is_current": "0"
},
{
"id": "643",
"name": "16/17",
"is_current": "0"
},
{
"id": "644",
"name": "15/16",
"is_current": "0"
},
{
"id": "645",
"name": "14/15",
"is_current": "0"
},
{
"id": "646",
"name": "13/14",
"is_current": "0"
},
{
"id": "647",
"name": "12/13",
"is_current": "0"
},
{
"id": "648",
"name": "11/12",
"is_current": "0"
},
{
"id": "649",
"name": "10/11",
"is_current": "0"
},
{
"id": "650",
"name": "09/10",
"is_current": "0"
}
]
},
"meta": {
"requests_left": 962251,
"user": "soccersapi2",
"plan": "Soccer API +1000",
"pages": 1,
"page": 1,
"count": 1,
"total": 1,
"msg": null
}
}Modified at 2025-10-03 13:48:00