Parameter Search Countries Guide

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

Use this API to search for countries by partial or full name — useful for autocomplete fields.

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

Endpoint

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

Query Parameters

Parameter	Required	Description
name	No	Partial or full country name to search for.
rows	No	Maximum number of results to return.

Request Example

curl --location --request GET 'https://ppapi.qima.com/parameter/v2/searchCountries?name=China' \
  --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

{
    "message": null,
    "content": [
        { "label": "China", "value": "23424781" }
    ]
}

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

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