Skip to main content

List country regions

GET 

/api/v2/numbers/countries/:country_id/regions

Retrieve a list of states or provinces within a country (e.g., US states, Canadian provinces).

Important notes:

  • Only applicable for countries with has_provinces_or_states: true
  • Returns 404 for countries without regional divisions
  • A state's numbers are listed by search_available_numbers with the state's region_id

regions[].id feeds search_available_numbers (region_id). regions[].name feeds search_available_numbers (state_name_contains, United States only).

Request​

Responses​

returns list of regions