Get Cities

Returns a list of cities which belong to a specific country or state, or both.

If a country and state are not specified, all cities will be returned.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string | null

ISO-3166 alpha-2 code.
If it is set, only the specified country states will be returned.

string | null

Specific local code of the exact state.

2-3 digits code (Available in the Web base IC system).

int32
1 to 2147483647

The number of the next page.
(Default is 1)

int32
1 to 1000

This is the maximum number of records per page that can be returned to the client.
Must be between 1 and 1000. (Default is 50)

Headers
string
required
^[A-Z]{2}[0-9A-Z]{4}$

This is the agent correspondent id provided to the agent by the IC Operations department. It is used to facilitate API management and auditing.

string
\w{8}-\w{4}-\w{4}-\w{4}-\w{12}

This header is used to uniquely identify the HTTP request and to facilitate troubleshooting.

string
\w{8}-\w{4}-\w{4}-\w{4}-\w{12}

Unique request identifier to support idempotency. You may generate (UUID v4) value using the programming language.

Responses

Language
Credentials
Header
LoadingLoading…
Response
Choose an example:
application/json