Get Province List

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.

🔒

No Access Control.

This API retrieves a list of provinces or states for a specified country. The list of provinces is based on the provided country code and can be used for administrative purposes or region-specific operations.

Path Parameters

FieldTypeRequiredDescriptionExample
countrystringYescode of the country.

Response Description

Public Response Fields

📘

Success Response

FieldTypeExampleDescription
codestring"success"Status code of the response
messagestringDescriptive message of the response
data.provinces.cn_namestring北京The Chinese name of province
data.provinces.codestringBJThe code of provinces
data.provinces.country_code2stringCNThe country_code2 of provinces
data.provinces.namestringBeijingThe name of provinces
data.provinces.old_codestringPekingThe old_code of provinces
data.provinces.province_idinteger1The province_id of provinces

Error Detail

FieldTypeExampleDescription
codestringInvalidParameterError http message
messagestring``Error message
Language
Credentials
Header
URL
Click Try It! to start a request and see the response here!