Ir al contenido

Código postal de un punto

GET/v1/reversePlanes de pago (Básico o superior)

¿Qué hace?

El código postal de un punto del mapa; por ejemplo, de la ubicación de tu usuario o de una entrega.

El código postal cuya área contiene el punto. Las áreas cubren el territorio terrestre de México, incluidos unos 4,500 códigos postales rurales sin asentamientos en el catálogo de SEPOMEX (in_sepomex_catalog: false). Las áreas están simplificadas a unos 10 m: un punto justo en el límite puede dar el vecino. Un punto fuera de todas las áreas responde 404 /errors/location-not-covered. Los 537 códigos postales sin área propia (ubicados con locality_centroid o municipality_centroid) nunca salen aquí: su punto de referencia cae dentro del área de otro código postal.

La petición

ParámetroTipoValores aceptadosDescripción
laten la consultaobligatorionúmero
de -90 a 90
Latitud en grados decimales (WGS84), hasta 20 decimales (como la da un GPS o un navegador); se redondea a 6 (unos 10 cm).
lonen la consultaobligatorionúmero
de -180 a 180
Longitud en grados decimales (WGS84), hasta 20 decimales (como la da un GPS o un navegador); se redondea a 6 (unos 10 cm).

Ejemplo

curl -H "x-api-key: TU_LLAVE" "https://colonix.silgaru.mx/v1/reverse?lat=19.4195&lon=-99.1617"

Cambia TU_LLAVE por tu llave; en los lenguajes, se lee de la variable de entorno COLONIX_API_KEY. Esta petición es la que produjo la respuesta de abajo.

La respuesta

Respuesta real a la petición del ejemplo. Viene con los encabezados ETag, X-Data-Version, Cache-Control.

200 OK
{
"postal_code": "06700",
"in_sepomex_catalog": true,
"state": {
"id": "09",
"name": "Ciudad de México"
},
"municipality": {
"id": "015",
"name": "Cuauhtémoc"
},
"settlement_count": 1,
"precision": "postal_code_polygon",
"source_date": "2026-01-05",
"data_version": "2026.11.05-36a7823b"
}

Campos

CampoTipoDescripción
postal_codetextoCódigo postal de 5 dígitos (conserva los ceros iniciales). Con 4 dígitos, si existe el código con un cero adelante, el detail del 400 lo sugiere (las hojas de cálculo convierten 09700 en 9700).
in_sepomex_catalogbooleanoEl código postal tiene asentamientos en el catálogo de SEPOMEX
stateobjetoElemento de un catálogo.
state.idtextoClave oficial
state.nametextoNombre
municipalityobjeto o nullMunicipio, o null si el código postal no está en el catálogo de SEPOMEX
municipality.idtextoClave oficial
municipality.nametextoNombre
settlement_countenteroNúmero de asentamientos (0 si no está en el catálogo)
precisiontextoSiempre postal_code_polygon
postal_code_polygon
source_datetextoFecha de las áreas de los códigos postales
data_versiontextoVersión del dato

Errores

Todos en formato application/problem+json; ninguno cuenta para tu cuota. Qué hacer con cada uno: Errores.

EstadoCuándo
400Parámetro inválido o repetido (/errors/invalid-parameter), un parámetro que el endpoint no tiene (/errors/unknown-parameter), cursor vencido (/errors/cursor-expired), versión del dato desconocida (/errors/unknown-version) o as_of fuera del historial registrado (/errors/as-of-out-of-range).
401Credenciales faltantes (/errors/missing-api-key) o inválidas (/errors/invalid-api-key).
403Llave suspendida (/errors/api-key-suspended) o endpoint fuera de tu plan (/errors/plan-not-allowed).
404Ningún área de código postal contiene el punto (/errors/location-not-covered).
429Se alcanzó la cuota mensual (/errors/quota-exceeded) o el límite por minuto (/errors/rate-limited). La respuesta del límite por minuto trae el mismo cuerpo, pero con Content-Type: application/json.
5XXError inesperado (/errors/internal-error) o servicio no disponible por un momento (503, que puede llegar sin cuerpo). Reintenta unas cuantas veces, esperando cada vez más.