Código postal de un punto
/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ámetro | Tipo | Valores aceptados | Descripción |
|---|---|---|---|
laten la consultaobligatorio | nú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 consultaobligatorio | nú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"const url = new URL("https://colonix.silgaru.mx/v1/reverse");url.searchParams.set("lat", "19.4195");url.searchParams.set("lon", "-99.1617");
const res = await fetch(url, { headers: { "x-api-key": process.env.COLONIX_API_KEY }, signal: AbortSignal.timeout(5000),});const data = await res.json();if (!res.ok) throw new Error(`${data.type}: ${data.detail}`);
console.log(data);import osimport requests
res = requests.get( "https://colonix.silgaru.mx/v1/reverse", params={"lat": "19.4195", "lon": "-99.1617"}, headers={"x-api-key": os.environ["COLONIX_API_KEY"]}, timeout=5,)data = res.json()if not res.ok: raise RuntimeError(f"{data['type']}: {data['detail']}")
print(data)<?php$url = "https://colonix.silgaru.mx/v1/reverse?" . http_build_query(["lat" => "19.4195", "lon" => "-99.1617"]);$ch = curl_init($url);curl_setopt_array($ch, [ CURLOPT_HTTPHEADER => ["x-api-key: " . getenv("COLONIX_API_KEY")], CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 5,]);$data = json_decode(curl_exec($ch), true);if (curl_getinfo($ch, CURLINFO_RESPONSE_CODE) !== 200) { throw new RuntimeException("{$data['type']}: {$data['detail']}");}
print_r($data);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.
{ "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
| Campo | Tipo | Descripción |
|---|---|---|
postal_code | texto | Có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_catalog | booleano | El código postal tiene asentamientos en el catálogo de SEPOMEX |
state | objeto | Elemento de un catálogo. |
state.id | texto | Clave oficial |
state.name | texto | Nombre |
municipality | objeto o null | Municipio, o null si el código postal no está en el catálogo de SEPOMEX |
municipality.id | texto | Clave oficial |
municipality.name | texto | Nombre |
settlement_count | entero | Número de asentamientos (0 si no está en el catálogo) |
precision | texto | Siempre postal_code_polygonpostal_code_polygon |
source_date | texto | Fecha de las áreas de los códigos postales |
data_version | texto | Versión del dato |
Errores
Todos en formato application/problem+json; ninguno cuenta para tu cuota. Qué hacer con cada uno: Errores.
| Estado | Cuándo |
|---|---|
400 | Pará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). |
401 | Credenciales faltantes (/errors/missing-api-key) o inválidas (/errors/invalid-api-key). |
403 | Llave suspendida (/errors/api-key-suspended) o endpoint fuera de tu plan (/errors/plan-not-allowed). |
404 | Ningún área de código postal contiene el punto (/errors/location-not-covered). |
429 | Se 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. |
5XX | Error 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. |
© 2026 Silgaru