Query city list

Overview

Retrieve province and city reference data for a country. Use this after the country list when building location selectors or mapping local city records.

When to use

  • A user has selected a country and the application needs its cities.
  • Refreshing country-to-city mappings for a Standard API Integration.

What you get

  • Province and city names and codes.
  • City coordinate and time-zone fields when returned.

Integration notes

Pass the target country code and the display language. The response data is an array directly; it is not wrapped in a provinces object. Cache the result because it is static reference data.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Pass the business request body directly. Do not wrap it in header / businessRequest.

string

Language. zh-CN for Chinese and en-US for English. Defaults to English.

string
required

Country code

Responses

Language
Credentials
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json