Skip to main content

List States

Returns the list of states or provinces for a given country. Only applicable to countries that have states/provinces in the system (currently the United States, Canada, and Mexico).

Query Parameters
country_id integer — REQUIRED

Country ID. Use the List Countries endpoint to get available country IDs.

Responses
200

OK

Schema — OPTIONAL
httpCode number — OPTIONAL
status string — OPTIONAL
states object[] — OPTIONAL

list of states

id integer — OPTIONAL
name string — OPTIONAL
short_name string — OPTIONAL
400

INVALID DATA

Schema — OPTIONAL
httpCode integer — OPTIONAL

Possible values: [400]

status string — OPTIONAL
message string — OPTIONAL

Possible values: [country id error]