Parameter All Countries Guide

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

Use this API to retrieve the complete list of countries in QIMA's reference data.

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

Endpoint

GET https://ppapi.qima.com/parameter/v2/countries

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/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 real list has hundreds of entries — trimmed to the first 2 here.

{
    "message": null,
    "content": [
        { "label": "Afghanistan", "value": "23424739" },
        { "label": "Aland", "value": "12577865" }
    ]
}

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.

Next Steps

If you only need to look up one or two countries (e.g. for an autocomplete field), use Search Countries by Name instead of fetching the full list.

Documents