The API uses environment variables to launch API calls: {{USERNAME}} and {{TOKEN}}. You can set them from TRY IT OUT

Leagues by Multiple ID

GET

/v2.2/leagues/

The Leagues by Multiple IDs endpoint retrieves details for several leagues in a single request.
Instead of calling the league endpoint multiple times, you can pass a list of league IDs to receive their information at once.

This is useful when you need to display or validate multiple leagues simultaneously without making multiple API calls.

Typical Use Cases

Fetch details for all the leagues a user has selected in their plan.

Populate a multi-league dashboard or dropdown with league names, countries, and IDs in one response.

Improve performance by batching requests instead of sending one request per league.

Example: requesting id=974,1005,1609 returns details for the Australia A-League, Austria Bundesliga, and Denmark Superligaen.

Example Request

Request

Query Params

Responses

🟢200OK

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location -g --request GET '/v2.2/leagues/?user={{USERNAME}}&token={{TOKEN}}&t=sort&ids=974, 1005, 1609'

Response Example

{
    "data": [
        {
            "id": "974",
            "name": "A-League",
            "is_cup": "0",
            "is_amateur": "0",
            "is_friendly": "0",
            "img": "https://cdn.soccersapi.com/images/soccer/leagues/100/974.png",
            "id_current_season": "15682",
            "id_current_stage": "1",
            "id_current_round": "205550",
            "continent": {
                "id": "7",
                "name": "Oceania"
            },
            "country": {
                "id": "14",
                "name": "Australia",
                "cc": "au"
            },
            "seasons": []
        },
        {
            "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": "1609",
            "name": "Superligaen",
            "is_cup": "0",
            "is_amateur": "0",
            "is_friendly": "0",
            "img": "https://cdn.soccersapi.com/images/soccer/leagues/100/1609.png",
            "id_current_season": "15238",
            "id_current_stage": "1",
            "id_current_round": "197735",
            "continent": {
                "id": "2",
                "name": "Europe"
            },
            "country": {
                "id": "37",
                "name": "Denmark",
                "cc": "dk"
            },
            "seasons": []
        }
    ],
    "meta": {
        "requests_left": 958834,
        "user": "soccersapi2",
        "plan": "Soccer API +1000",
        "pages": 1,
        "page": 1,
        "count": 0,
        "total": 3,
        "msg": null
    }
}

Modified at 2025-10-03 13:53:18

League by ID

Leagues by Country

Leagues by Multiple ID

Typical Use Cases#

Example Request#

Request

Responses

Typical Use Cases

Example Request