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

Country by ID

GET

/v2.2/countries/

The Country by ID endpoint retrieves detailed information about a single country using its unique id.
It returns the country’s name, ISO code, continent, and image flag.

This endpoint is useful when you already know a country_id (for example, from a league, team, or venue object) and want to confirm its details or display localized information in your app.

Typical Use Cases

Show the full country profile on a team, player, or league page.

Validate a country_id before using it in another request.

Power country selectors with localized names and flags.

Example: requesting id=15 returns details for Austria.

Example Request

Request

Query Params

Responses

🟢200OK

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location -g --request GET '/v2.2/countries/?user={{USERNAME}}&token={{TOKEN}}&t=info&id=4'

Response Example

{
    "data": {
        "id": 4,
        "name": "Germany",
        "continent": "Europe",
        "sub_region": null,
        "long": null,
        "lat": null,
        "img": "https://cdn.soccersapi.com/images/countries/30/de.png",
        "code": "de"
    },
    "meta": {
        "requests_left": 967809,
        "user": "soccersapi2",
        "plan": "Free Plan",
        "pages": 1,
        "page": 1,
        "msg": ""
    }
}

Modified at 2025-10-03 13:41:10

All countries

All Leagues

Country by ID

Typical Use Cases#

Example Request#

Request

Responses

Typical Use Cases

Example Request