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]