Referencia de la API
Cada endpoint de Colonix tiene su página con lo que hace, lo que recibe y lo que responde, con un ejemplo real. Elige el que necesitas.
Lo que vale para todos
- Dirección
https://colonix.silgaru.mx/v1/…- Autenticación
- Tu llave en el encabezado
x-api-key(Llaves). - Métodos
GETyHEAD.- Formato
- JSON en UTF-8; los errores,
application/problem+json(Errores). - Versión del dato y caché
- En
data_version,X-Data-VersionyETag; un día de caché (Paginación y versión del dato).
Códigos postales
- GETConsultar un código postal
/v1/postal-codes/{code}Todo sobre un código postal.Todos los planes - GETConsulta en lote
/v1/postal-codes/batchConsulta muchos códigos postales a la vez; por ejemplo, para revisar todas las direcciones de tu lista de clientes.Negocio y Enterprise - GETBuscar códigos postales
/v1/postal-codesEncuentra códigos postales por zona.Todos los planes
Asentamientos
- GETValidar colonia y CP
/v1/validate/postal-code-settlementRevisa que la colonia que escribió tu usuario de verdad pertenezca al código postal, antes de guardar la dirección, enviar o facturar.Todos los planes - GETAutocompletar
/v1/autocompleteSugiere asentamientos mientras tu usuario escribe, aunque se equivoque, para que elija el correcto en lugar de escribirlo.Todos los planes - GETBuscar asentamientos
/v1/settlementsBusca asentamientos por nombre, código postal, estado o ciudad; por ejemplo, para encontrar el código postal de una colonia cuando el usuario solo sabe su nombre.Todos los planes - GETAsentamientos de un municipio
/v1/municipalities/{state}/{municipality}/settlementsTodos los asentamientos de un municipio; por ejemplo, para cargar las colonias de un municipio en tu sistema.Todos los planes
Catálogos
- GETEstados
/v1/statesLos 32 estados de México con sus claves del INEGI, para un selector de estado o para filtrar otros endpoints.Todos los planes - GETMunicipios de un estado
/v1/states/{state}/municipalitiesLos municipios (o alcaldías) de un estado con sus claves, para un selector de municipio o para filtrar otros endpoints.Todos los planes - GETTipos de asentamiento
/v1/settlement-typesLos tipos de asentamiento que usa SEPOMEX, para filtrar búsquedas portype.Todos los planes - GETVersión del dato y totales
/v1/metaLa versión vigente del dato, la fecha de cada fuente y los totales del catálogo.Todos los planes
Cambios
- GETHistorial de un CP
/v1/postal-codes/{code}/historyQué le pasó a un código postal con el tiempo.Todos los planes - GETCambios desde una versión
/v1/changesQué cambió en el catálogo desde la versión que tienes, para actualizar solo eso en tu propia base de datos en lugar de volver a consultar todo.Negocio y Enterprise
SAT
Geografía
- GETCP de un punto
/v1/reverseEl código postal de un punto del mapa; por ejemplo, de la ubicación de tu usuario o de una entrega.Planes de pago (Básico o superior) - GETCPs cercanos
/v1/nearbyLos códigos postales alrededor de un punto, del más cercano al más lejano; por ejemplo, para revisar la cobertura de entrega alrededor de una tienda.Planes de pago (Básico o superior)
El contrato OpenAPI
Toda esta referencia sale del contrato OpenAPI 3.1 de Colonix. Descárgalo para importarlo en Postman, Insomnia o Bruno, o para generar un cliente en tu lenguaje.
© 2026 Silgaru