Parameter Countries by Continent Guide

Latest Update Time: 2026-07-02 00:00:00

Use this API to retrieve all countries belonging to a specific continent.

See the Parameter Introduction for base URL, authentication, and required headers.

Endpoint

GET https://ppapi.qima.com/parameter/v2/continent/{continentId}/countries

Prerequisites

A continentId obtained from Get All Continents

Path Parameters

Parameter	Required	Description
`continentId`	Yes	Continent ID, from Get All Continents.

Query Parameters

Parameter	Required	Description
`refresh`	No	Send `false` (default) to use the server cache, or `true` to force a fresh lookup.

Request Example

curl --location --request GET 'https://ppapi.qima.com/parameter/v2/continent/24865671/countries' \
  --header 'Ai-Api-Access-Token: {your api access token}' \
  --header 'Ai-User-Id: {your user ID}' \
  --header 'Authorization: Bearer {your token}' \
  --header 'Referer: https://preprodmy.qima.com/'

Successful Response

The example below requested continentId=24865671 (Asia) — the response is trimmed to 3 of many countries.

{
    "message": null,
    "content": [
        { "label": "Uzbekistan", "value": "23424980" },
        { "label": "Vietnam", "value": "23424984" },
        { "label": "Yemen", "value": "23425002" }
    ]
}

Response Field Notes

Field	Notes
`content[].label`	Country display name.
`content[].value`	The country ID. Use this as `supplierCountryID`/`factoryCountryID`, or pass it to Get Provinces by Country or Get Cities by Country.

Common Errors

See common authentication errors for 401 and 403 responses.

Status	Meaning	Recommended Action
`500 Internal Server Error`	Lookup failed on the server, e.g. an invalid `continentId`.	Confirm `continentId` came from Get All Continents.

Next Steps

Use a country's value to look up its provinces or cities.

Documents