Lookup

Look up a postal code

Returns the state, municipality, and all settlements associated with a postal code.

get/api/v1/{country}/cp/{codigo}

Request

  • Base URL: https://postali.app
  • URL: https://postali.app/api/v1/{country}/cp/{codigo}
  • 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.

codigostring required
Example:06700

Postal code in the country's format (5 digits for MX/ES, 6 for CO).

Response

Successful lookup.

cpstring required
estadostring required
estado_slugstring required
municipiostring required
municipio_slugstring required

Example response

{
  "cp": "06700",
  "estado": "Ciudad de México",
  "estado_slug": "ciudad-de-mexico",
  "municipio": "Cuauhtémoc",
  "municipio_slug": "cuauhtemoc",
  "asentamientos": [
    {
      "nombre": "Roma Norte",
      "tipo": "Colonia",
      "ciudad": "Ciudad de México",
      "asenta_slug": "roma-norte"
    }
  ]
}

Changes

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