Get States

Returns a list of states which belong to a specific country.

If the countryCode is not specified, all states 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. (Optional)
If it is set, only the specified country states will be returned.

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