Get national province/state list interface

Get the province or state list under a specified country, for address completion function.

Request address

{域名地址}/api/place/country/states

Description:{域名地址}Replace it with your domain name, such ashttps://en.anqicms.com/api/place/country/states

Request Syntax

GET {域名地址}/api/place/country/states?{参数}

Request Headers

This interface involves only public request headers. For more information, please refer toCommon Request Headers (Common Request Headers).

Request parameters

Field name	Type	Required	Description
country_code	string	No	Country Code (either one)
Country Name	string	No	Country Name (either one)

Response header

This interface only involves common response headers. For more information, please refer toCommon Request Headers (Common Request Headers).

Return parameters

Field name	Type	Description
code	int	Error code
msg	string	Error description
data	object[]	List of Provinces/States

data result item parameter

Field name	Type	Description
id	int	Province/State ID
name	string	Province/State Name
iso2	string	ISO2 Code
latitude	string	latitude
longitude	string	longitude

Usage Example

Request example

GET /api/place/country/states?country_code=CN HTTP/1.1
Host: your-domain.com
Content-Type: application/json

Response Example

{
  "code": 0,
  "data": [
    {
      "id": 12,
      "name": "Beijing",
      "iso2": "BJ",
      "latitude": "39.9042",
      "longitude": "116.4074"
    },
    {
      "id": 13,
      "name": "Shanghai",
      "iso2": "SH",
      "latitude": "31.2304",
      "longitude": "121.4737"
    },
    {
      "id": 21,
      "name": "Guangdong",
      "iso2": "GD",
      "latitude": "23.1291",
      "longitude": "113.2644"
    }
  ],
  "msg": ""
}

error code

Error code	Description
0	OK
-1	Error, the reason is indicated in msg