Get states by country

Retrieve all states or provinces available for a given country code—returns official names and codes for address forms and validation.

When to use this endpoint:

  • Populating state/provinces for shipment origins or destinations
  • Validating user-entered addresses

What do you need?

  • Required: Two-digit country code (e.g., US, MX, CA)

What else should you know?

  • Response includes state/province names and codes for use in forms or validation
Language
Credentials
Bearer
JWT
URL
Click Try It! to start a request and see the response here!