Application API Utilities countries states GET

October 15, 2026 at 9:35 AM

/countries/{iso}/states [GET]

Return list of states for the given country (by ISO code) - protected.

Parameters

  • country (string) - provided as part of the URI, must be a valid 2-letter ISO code.

Response Messages

403 Forbidden - if country is not a valid ISO code.

{ "fail" : "Invalid Argument" }

200 OK - success

{  
  "states" : [

An alphabetical array of state names for the specified country. May be empty.

    "Alaska",
    "American Samoa",
    ...
  ]
}