Cambios de la API
Aquí anotamos cada cambio de la API: endpoints, parámetros y campos nuevos, y las correcciones que
cambian una respuesta. Si ya integraste Colonix, es lo que te conviene revisar de vez en cuando.
Los cambios del catálogo (una colonia nueva, un nombre corregido) no van aquí: esos te los da
/v1/changes.
Cómo cambia la API
Section titled “Cómo cambia la API”- Dentro de
/v1, los cambios solo agregan: endpoints, parámetros opcionales, campos en las respuestas o valores nuevos en un campo que ya existe. Nada se quita ni cambia de significado. - Tu código debe ignorar los campos que no conozca y aceptar un valor nuevo sin fallar. Por
ejemplo, si tu código decide con el
outcomede la validación, dale un camino para un valor que no conoce (como pedir que alguien revise la dirección). - Con los parámetros es al revés: la API no ignora uno que no conoce, responde
400conunknown-parameter. Manda un parámetro nuevo solo cuando aparezca en esta página y en la referencia. - Un cambio que pueda romper tu integración llega en una versión nueva (
/v2). Cuando exista,/v1seguirá funcionando al menos 30 días, y te avisaremos por correo y aquí (Términos, sección 29). - Las correcciones de errores pueden cambiar una respuesta que era incorrecta; también se anotan aquí.
Historial
Section titled “Historial”. Primera versión pública de la API, con 17 endpoints:
- Códigos postales: un código postal con su estado,
municipio y colonias, y bajo pedido (
include) los datos del SAT, la ubicación y la zona metropolitana, o cómo estaba en una fecha (as_of); el lote de hasta 100 códigos, y la búsqueda de códigos postales por prefijo, estado, municipio o ciudad. - Asentamientos: la validación de código postal y colonia,
que dice su conclusión en
outcomey, coninclude=cfdi, arma el domicilio con las claves para Carta Porte y Comercio Exterior; la búsqueda y el autocompletado que toleran errores de escritura, y las colonias de un municipio. - Catálogos: estados, municipios, tipos de asentamiento y la versión del dato.
- Cambios: los cambios del catálogo desde una versión y el historial de un código postal, con el del SAT bajo pedido.
- SAT: todo lo que dice el SAT de un código postal para CFDI 4.0, también en una fecha pasada, y las diferencias entre el SAT y SEPOMEX.
- Geografía: el código postal de un punto y los códigos postales cercanos.
En toda la API: llave en x-api-key, solo GET y HEAD, errores en application/problem+json
(errores), paginación con cursor y revalidación con ETag
(paginación y versión del dato). El contrato completo está en
OpenAPI.
© 2026 Silgaru