Geography

List top-level administrative regions

Returns all level-1 regions (states for MX, departments for CO, provinces for ES) with pre-computed totals.

get/api/v1/{country}/estados

Request

  • Base URL: https://postali.app
  • URL: https://postali.app/api/v1/{country}/estados
  • Auth: none required

Path parameters

country'mx' | 'co' | 'es' required
Example:mx

ISO 3166-1 alpha-2 country code in lowercase. The path /api/v1/cp/... (without country) defaults to mx for backwards compatibility.

Response

List of regions.

totalinteger required

Example response

{
  "total": 32,
  "estados": [
    {
      "nombre": "Jalisco",
      "slug": "jalisco",
      "total_asentamientos": 6475,
      "total_municipios": 125
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.