List provinces

GET 
/openapi/2025-06/areas/country/:country/province

The Province List API allows developers to fetch a comprehensive list of provinces within a specified country using its unique identifier. This endpoint supports retrieving specific fields based on the user’s request.

Request

Path Parameters

country stringrequired

Country code (e.g., CN)

Responses

200

OK

application/json

Schema

Schema

codestring

error code

messagestring

error message

data object
provinces object[]
The list of provinces
Array [
cn_namestring
Chinese name of the province
codestring
Code of the province
country_code2string
Code of the country
namestring
English name of the province
old_codestring
Old code of the province
province_idint32
Province ID
]

Example

json

{
  "code": "string",
  "message": "string",
  "data": {
    "provinces": [
      {
        "cn_name": "string",
        "code": "string",
        "country_code2": "string",
        "name": "string",
        "old_code": "string",
        "province_id": 0
      }
    ]
  }
}