EntrarCrear cuenta
Un producto de

Cada código postal.Cada colonia.Sin errores de captura.

Para facturas, envíos y formularios: los datos de SEPOMEX, el SAT, el INEGI y CONAPO, cruzados, validados, servidos en milisegundos.

códigos postales
31,868
asentamientos de SEPOMEX
159,462
colonias con su clave del SAT
120,535
municipios
2,478

Validación con el catálogo del SAT

Detecta el error
antes de timbrar.

Valida el código postal y la colonia que escribe tu cliente, sugiere la correcta sin corregir en silencio y entrega las claves del SAT para el CFDI 4.0.

Todo lo que pide
una dirección mexicana.

Desde que tu cliente escribe hasta que facturas o envías: búsqueda, consulta, claves fiscales, ubicación e historial, sobre los catálogos oficiales cruzados.

Todos los planes

Autocompletado que entiende errores de dedo.

Sugiere colonias mientras tu cliente escribe, aunque escriba «Monterey».

Guía: autocompletar la colonia en un formulario

GET /v1/autocomplete?q=monterey cen&fuzzy=true

Desde Básico

El código postal de un punto en el mapa.

Manda una coordenada y recibe su CP, o los CPs a la redonda, con los polígonos oficiales de SEPOMEX.

Guía: el código postal desde unas coordenadas06700

GET /v1/reverse?lat=19.4195&lon=-99.162

→ "postal_code": "06700"

  • 06700 0.15 km
  • 06600 0.85 km
  • 06500 1.37 km
  • 06720 1.39 km
  • 06760 1.44 km
  • 06100 1.50 km

Pasa el cursor por un CP para verlo en el mapa.

Polígonos de CP: Servicio Postal Mexicano (SEPOMEX), datos.gob.mx, CC-BY-4.0, corte del 05/01/2026; simplificados por Colonix para esta ilustración.

Todos los planes

Un CP, todo lo que necesitas.

Estado, municipio y colonias, en todos los planes. Desde Básico, la ubicación y la zona metropolitana, solo si las pides.

Pide más datos:

GET /v1/postal-codes/64000

{  "postal_code": "64000",  "state": { "id": "19", "name": "Nuevo León" },  "municipality": { "id": "039", "name": "Monterrey" },  "settlements": [ "La Finca", "Monterrey Centro" ],  "location": { "lat": 25.675964, "lon": -100.316726 },  "metro_area": { "name": "Monterrey", "type": "Zona metropolitana" },  "data_version": "2026.11.05-36a7823b"}
Desde Básico

Las claves que pide el CFDI 4.0.

Del catálogo del SAT, con el estímulo de la región fronteriza y hasta cuándo está vigente, y la hora local real del código postal.

Guía: validar una dirección para CFDI 4.0

GET /v1/sat/postal-codes/22000

c_CodigoPostal
22000
c_Estado
BCN
c_Municipio
004
c_Localidad
04
Estímulo fronterizo
Región norte
Huso horario
Noroeste · UTC−8 / −7

Estos cinco CPs de demostración responden con datos del SAT en cualquier plan, también en el gratuito.

Desde Negocio

El catálogo de SEPOMEX cambia. Tú te enteras.

Cada lunes lo revisamos y, si algo cambió, lo registramos: qué CPs y colonias se dieron de alta, de baja o cambiaron. El historial de cada CP está en todos los planes.

Guía: mantener tu catálogo al día

GET /v1/changes?since=2026.10.29-0384b36e

Actualización del 05/11/2026

altas
32
bajas
5
modificaciones
45

También: consulta en lote de hasta 100 CPs por petición (desde Negocio), catálogos de estados, municipios y tipos de asentamiento, y la validación de CP y colonia que viste arriba.

Una petición.
La dirección completa.

Tu llave va en un encabezado. Recibes el CP con sus colonias y las claves del SAT, y si algo falla, un error que tu código puede leer.

GET

/v1/postal-codes/?include=sat

Sin llave responden los CPs de demostración:y uno que no existe:

curl -sS --fail-with-body \
  -H "x-api-key: $COLONIX_API_KEY" \
  "https://colonix.silgaru.mx/v1/postal-codes/06700?include=sat"
const res = await fetch(
  "https://colonix.silgaru.mx/v1/postal-codes/06700?include=sat",
  {
    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.settlements.map((s) => s.name));
import os
import requests

res = requests.get(
    "https://colonix.silgaru.mx/v1/postal-codes/06700",
    params={"include": "sat"},
    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([s["name"] for s in data["settlements"]])
$ch = curl_init(
    "https://colonix.silgaru.mx/v1/postal-codes/06700?include=sat"
);
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(array_column($data["settlements"], "name"));

HTTP/1.1 200 OK

Content-Type: application/json; charset=utf-8Cache-Control: public, max-age=86400, stale-while-revalidate=604800, stale-if-error=604800ETag: "2026.11.05-36a7823b+10"X-Data-Version: 2026.11.05-36a7823b
{  "postal_code": "06700",  "state": {"id": "09", "name": "Ciudad de México"},  "municipality": {"id": "015", "name": "Cuauhtémoc"},  "office": "06401",  "settlement_count": 1,  "settlements": [    {      "id": "09015-0947",      "name": "Roma Norte",      "type": "Colonia",      "zone": "Urbano",      "city": "Ciudad de México"    }  ],  "sat": {    "in_sat": true,    "in_sepomex": true,    "state": {"sat_code": "CMX", "id": "09", "name": "Ciudad de México"},    "municipality": {"sat_code": "015", "name": "Cuauhtémoc"},    "locality": {"sat_code": "06", "name": "Ciudad de México"},    "border_stimulus": null,    "border_stimulus_decree": null,    "time_zone": {      "description": "Tiempo del Centro",      "utc_offset_summer": -6,      "utc_offset_winter": -6,      "dst_start": null,      "dst_end": null,      "iana": "America/Mexico_City",      "utc_offset_standard": -6,      "utc_offset_dst": null,      "matches_sat": true    },    "settlements": [      {        "c_colonia": "0947",        "name": "Roma Norte",        "settlement_id": "09015-0947",        "match": "exact",        "sepomex_name": "Roma Norte",        "sepomex_candidate": null      }    ],    "settlements_missing_in_sat": [],    "sat_revision": {      "file": "catCFDI_V_4_20261029.xls",      "postal_codes": "8",      "settlements": "0",      "settlements_revised": false,      "published": "2026-01-22"    }  },  "data_version": "2026.11.05-36a7823b"}

Necesita tu llave

Aquí, sin llave, solo responden los CPs de demostración. Con tu llave, el y cualquier otro CP del catálogo.

Crear cuenta
  • ETag · X-Data-Version

    La versión del dato. Solo cambia cuando cambia el catálogo o la forma en que unimos SEPOMEX y el SAT, así tu caché sabe cuándo renovarse.

  • Cache-Control

    Un día en caché, y hasta una semana más con la copia anterior mientras se renueva o si algo falla.

  • sat.settlements

    La clave c_Colonia de cada colonia para el CFDI 4.0, y en settlements_missing_in_sat las que el SAT no tiene.

  • type · detail

    Si algo falla, un error RFC 9457 con un type fijo que tu código puede leer.

El contrato OpenAPI 3.1, la colección de Postman y el servidor MCP para tu asistente de IA vienen en la documentación. Ver documentación

¿Qué estás construyendo?

Elige tu caso: en qué momento de tu flujo entra Colonix y qué plan necesitas.

En el CFDI 4.0, el CP del receptor debe coincidir con su domicilio fiscal, y complementos como Carta Porte piden las claves del catálogo del SAT.

  1. Das de alta al cliente

    Desde Básico

    Valida el CP y la colonia contra el catálogo antes de guardarlos, con su clave c_Colonia.

    GET /v1/validate/postal-code-settlement?postal_code=44100&settlement=Guadalajara Centro&include=sat

    → "outcome": "valid", "c_colonia": "0003"

  2. Timbras

    Las claves de estado, municipio y localidad salen del mismo catálogo que usa el SAT.

    GET /v1/sat/postal-codes/44100

    → c_Estado "JAL", c_Municipio "039", c_Localidad "03"

  3. Mantienes tu cartera al día

    Desde Negocio

    Cada lunes revisamos el catálogo de SEPOMEX. Pregunta qué cambió desde tu versión.

    GET /v1/changes?since=2026.10.29-0384b36e

    → 32 altas, 5 bajas y 45 modificaciones (05/11/2026)

Lo que necesitas: Plan Básico (cambios del catálogo, desde Negocio)

Una colonia mal escrita es un paquete que regresa. Mejor que tu cliente la elija a que la escriba.

  1. Escribe su código postal

    El estado y el municipio se llenan solos, y le ofreces sus colonias.

    GET /v1/postal-codes/77500

    → Quintana Roo, Benito Juárez, 16 colonias

  2. Busca su colonia

    Sugerencias mientras escribe, aunque se equivoque de letra.

    GET /v1/autocomplete?q=supermansana 23 c&fuzzy=true

    → "Supermanzana 23 Centro", 77500

  3. Confirmas antes de cobrar

    Si la escribió a mano, la validación sugiere la correcta y tu cliente decide.

    GET /v1/validate/postal-code-settlement?postal_code=77500&settlement=Sm 23

    → "valid": false, ¿Supermanzana 23 Centro?

Lo que necesitas: Plan Gratis, 10,000 consultas al mes

Para saber si llegas, a qué ruta va un envío y qué claves lleva el traslado, el CP tiene que salir de un punto en el mapa.

  1. Defines tu cobertura

    Los CPs a la redonda de tu almacén, del más cercano al más lejano.

    GET /v1/nearby?lat=25.7756&lon=-100.1937&radius_km=3

    → 7 CPs: 66600 a 0.19 km, 66604 a 1.13 km…

  2. Ubicas la entrega

    El CP del punto que reporta el GPS del repartidor o el mapa de tu app.

    GET /v1/reverse?lat=25.6866&lon=-100.3161

    → "postal_code": "64490", Monterrey

  3. Emites la Carta Porte

    Desde Básico

    Las claves del SAT del origen y del destino, del catálogo vigente.

    GET /v1/sat/postal-codes/64490

    → "NLE", "039", "07", c_Colonia "0275"

Lo que necesitas: Plan Básico

Un domicilio que no existe, o que no corresponde con donde está tu cliente, merece una segunda revisión.

  1. Recibes el domicilio

    Confirma que el CP y la colonia declarados existen y se corresponden.

    GET /v1/validate/postal-code-settlement?postal_code=03100&settlement=Del Valle Centro

    → "outcome": "valid", "match": "exact"

  2. Lo comparas con la ubicación

    Con permiso de tu cliente, el CP de donde está: una señal para revisar, no una prueba.

    GET /v1/reverse?lat=19.3832&lon=-99.1670

    → "postal_code": "03100", el mismo que declaró

  3. Revisas tu cartera

    Desde Negocio

    Hasta 100 CPs por petición, con found en cada uno para separar los que ya no existen.

    GET /v1/postal-codes/batch?codes=03100,06700,…

    → "found": true o false por cada CP

Lo que necesitas: Plan Básico (lote, desde Negocio)

Cuatro fuentes oficiales.
Cruzadas, con fecha.

Colonix no inventa datos: limpia y cruza los catálogos públicos, revisa SEPOMEX y el SAT cada lunes, y te dice dónde no coinciden.

SEPOMEX

Servicio Postal Mexicano

Los códigos postales y sus colonias, con tipo, zona y municipio, y el área de cada CP.

Catálogo: 05/11/2026 Polígonos: 05/01/2026

SAT

Servicio de Administración Tributaria

Las claves del CFDI 4.0 por CP y colonia, el estímulo de la región fronteriza y el huso horario.

Catálogo: 22/01/2026

INEGI

Instituto Nacional de Estadística y Geografía

Las localidades con las que se ubican los CPs que no tienen polígono.

Catálogo oficial

CONAPO

Consejo Nacional de Población

Las 92 metrópolis del país y sus 421 municipios, para include=metro.

Delimitación oficial

Lo que aparece al cruzarlas

La versión del dato viaja en cada respuesta

38,927

colonias de SEPOMEX sin clave c_Colonia en el catálogo del SAT, ni con su nombre ni escrito de otra forma. Te enteras antes de timbrar.

settlements_missing_in_sat

3,876

de esas probablemente son una colonia del SAT con el nombre escrito distinto, como «Dolores Tlalli» y «Dolores Tlali». Te la sugerimos para que la confirmes; nunca la damos como la clave. Cómo decidimos.

sat_candidate

1,739

colonias que el SAT escribe de otra forma, como «Buena Vista» y «Buenavista» o «Ojo de Agua» y «El Ojo de Agua». Son la misma, y te damos su clave.

match: equivalent

63,881

códigos postales que el SAT acepta y que no están en el catálogo de SEPOMEX.

in_sat · in_sepomex

537

CPs sin polígono, ubicados por su localidad del INEGI (461) o por su municipio (76). La respuesta dice cuál, y nunca los presenta como exactos.

location.precision

4,567

áreas de CP en los polígonos de SEPOMEX que no tienen colonias en su catálogo.

in_sepomex_catalog

Cada versión pasa por revisiones de calidad antes de publicarse: si una fuente llega incompleta, no se publica y la API sigue con la versión anterior. Fuentes y licencias

Casos reales.
Donde no coinciden.

Con el dato del 05/11/2026. SEPOMEX dice qué colonias tiene cada código postal; el SAT, qué claves lleva tu factura. Aquí no coinciden.

El SAT de un código postal viene desde el plan Básico

¿Y cuando el SAT escribe distinto el nombre de una colonia? Eso tiene su propia guía. Cómo unimos los nombres.

  1. Una colonia nueva que el SAT aún no tiene

    21320 Mexicali, Baja California

    SEPOMEX
    Punto Sur, agregada el 05/11/2026
    SAT
    9 colonias con clave, pero no esta

    Para tu factura: sabes que la colonia de tu cliente todavía no tiene clave antes de llenar un complemento con ella.

    Ninguna de las 28 colonias que SEPOMEX agregó el 05/11/2026 tiene clave del SAT todavía.

  2. Un código postal sin colonias en el SAT

    85772 Álamos, Sonora

    SEPOMEX
    37 colonias, como Agua Blanca, Aquinavo y Bavícora
    SAT
    Ninguna colonia, y tampoco le asigna municipio

    Para tu factura: no hay clave de colonia que buscar, y te lo decimos para que no la busques.

    Como este, 1,566 códigos postales: 3,581 colonias de SEPOMEX sin ninguna en el SAT.

  3. Un código postal que el SAT no tiene

    91312 Banderilla, Veracruz

    SEPOMEX
    Existe, con la colonia La Haciendita
    SAT
    No está en su catálogo de códigos postales

    Para tu factura: una factura con este código postal se rechaza. Te enteras antes de timbrar.

    Es el único código postal de SEPOMEX que falta en el catálogo del SAT.

  4. Lo que solo dice el SAT

    26200 Acuña, Coahuila

    SEPOMEX
    La dirección: colonias, municipio y estado
    SAT
    Región fronteriza norte y Tiempo del Centro en Frontera: UTC-6, UTC-5 en verano

    Para tu factura: sabes si el código postal está en la región del estímulo fiscal fronterizo y en qué huso horario, sin otra fuente.

    1,920 códigos postales están en la región del estímulo (1,555 en la frontera norte y 365 en la sur). Y cada código postal trae su huso horario: hay 5 en el país.

Empieza gratis.
Paga por lo que necesitas habilitar.

Todos los planes usan los mismos datos y la misma velocidad. Cambia lo que puedes pedir y cuánto.

Gratis

Para empezar y para formularios con poco tráfico

$0

Sin costo

10,000 consultas al mes

Crear cuenta

Sin tarjeta

Incluye:

  • Consulta por CP, búsqueda y autocompletado que entiende errores de dedo
  • Validación de CP y colonia con sugerencias
  • Historial de cada CP y catálogos
  • Ubicación, zona metropolitana y claves del SAT en los 5 CPs de demostración
Incluye el SAT

Básico

Para empresas que facturan y envían

$199

MXN al mes, IVA incluido

100,000 consultas al mes

Solicitar

14 días de prueba

Todo lo de Gratis, más:

  • Las claves del SAT para CFDI 4.0 y Carta Porte, en cualquier CP
  • Ubicación de referencia y zona metropolitana
  • El CP de un punto en el mapa
  • Los CPs a la redonda de un punto, del más cercano al más lejano

Negocio

Para plataformas, ERPs e integradores

$599

MXN al mes, IVA incluido

1,000,000 consultas al mes

Solicitar

14 días de prueba

Todo lo de Básico, más:

  • Consulta en lote: hasta 100 CPs por petición
  • Los cambios del catálogo desde tu versión
  • Las diferencias entre SEPOMEX y el SAT

Enterprise

Para volumen alto y condiciones propias

desde$1,999

MXN al mes, IVA incluido

5,000,000 consultas al mes

Solicitar

14 días de prueba

Todo lo de Negocio, más:

  • Volumen y condiciones a la medida
  • Soporte directo en español

Los planes de pago se solicitan. Te respondemos en máximo 3 días hábiles y, si la aprobamos, empiezas con 14 días de prueba, con todo lo que habilita el plan.

Sin cargos sorpresa. Al llegar a tu cuota, la API responde 429 hasta el mes siguiente o hasta que cambies de plan. Nunca te cobramos de más.

Preguntas frecuentes

Lo que suelen preguntar antes de integrar Colonix. El detalle técnico está en la documentación.

Ver documentación

¿Tu duda es sobre los códigos postales, el SAT o Carta Porte? Lee las guías de Aprende.

Los datos

¿De dónde salen los datos?

De cuatro instituciones públicas: el Servicio Postal Mexicano (SEPOMEX), el SAT, el INEGI y CONAPO. En Fuentes y licencias te contamos qué aporta cada una.

¿Cada cuánto se actualizan?

Cada lunes revisamos los catálogos de SEPOMEX y del SAT. Si algo cambió, lo revisamos antes de publicarlo y queda registrado, para que sepas qué códigos postales y colonias son nuevos, cuáles desaparecieron y cuáles cambiaron.

¿Qué hace Colonix con los datos?

Los limpia, los cruza y los mantiene al día. Une cada código postal con sus claves del SAT, lo ubica en el mapa, le asigna su zona metropolitana, entiende cuando alguien escribe una colonia con errores y guarda el historial de cambios. Tú haces una sola consulta y recibes todo junto.

¿Cómo funcionan las coordenadas?

Cada código postal tiene un punto de referencia, no una dirección exacta: sirve para ubicar la zona, no una casa. Casi siempre es el centro del área oficial del código postal; en los pocos que no tienen área usamos su localidad o su municipio, y la respuesta te dice cuál fue, para que sepas qué tan preciso es. Las coordenadas vienen desde el plan Básico.

Uso y cuotas

¿Cómo se cuentan las consultas?

Cada respuesta correcta cuenta como una consulta, y si pides varios códigos postales a la vez, cuenta uno por cada uno. Los errores no cuentan: si buscas un código postal que no existe, no se descuenta de tu cuota.

¿Qué pasa al llegar a mi cuota?

Te avisamos por correo al llegar al 80 % y al 100 %. Al llegar a tu cuota dejamos de responder hasta que empiece el mes siguiente o hasta que cambies de plan. Nunca te cobramos de más por pasarte.

¿Puedo descargar el catálogo completo?

No. Colonix es un servicio de consulta, no una copia del catálogo. Si necesitas tener al día tus propios códigos postales, puedes consultarlos en grupos de hasta 100 y preguntar qué cambió desde la última vez.

¿Puedo llamarla desde el navegador?

Por ahora, desde tu servidor, para que tu llave no quede a la vista en tu página: tu formulario le pregunta a tu sistema y tu sistema a Colonix.

¿Puedo usar Colonix desde mi asistente de IA?

Sí. Con el servidor MCP de Colonix, que corre en tu computadora con tu llave, Claude, Cursor u otro asistente consulta códigos postales, colonias y, según tu plan, las claves del SAT, solo para leer. Cada consulta cuenta en tu plan igual que una llamada a la API; cuando el asistente lee la documentación de Colonix que trae el servidor, no cuenta. Cómo instalarlo: Colonix en tu asistente de IA.

Documentación, cuenta y privacidad

¿Dónde está la documentación técnica?

En silgaru.mx/colonix/docs. Ahí está cómo hacer tu primera consulta en un par de minutos, cómo funcionan las llaves y los planes, qué significa cada error y cómo resolverlo, y guías para casos comunes: validar una dirección para facturar, autocompletar la colonia en un formulario o encontrar el código postal de un punto en el mapa. También hay una colección de Postman para probarla sin escribir código.

¿Por qué mi cuenta es de Silgaru?

Porque Silgaru es la empresa que hace Colonix. Tu cuenta es de Silgaru: con ella entras en cuenta.silgaru.mx, creas tus llaves de Colonix y, cuando lancemos otros productos, los usarás con la misma cuenta. Los correos de tu cuenta llegan de cuenta@silgaru.mx.

¿Cómo contrato un plan de pago?

Con el botón «Solicitar» del plan que te interesa. Te respondemos y, si la aprobamos, empiezas con 14 días de prueba, con todo lo que incluye el plan.

¿Cómo les escribo?

Desde tu cuenta, en «Escríbenos»: lo lee una persona y te responde a tu correo. También puedes escribir a contacto@silgaru.mx. Lo de tu cuenta (tus llaves, tu plan o tus datos) solo lo atendemos desde tu panel o desde el correo de tu cuenta, y nunca te pedimos tu código para entrar ni tus llaves.

¿Puedo pagar desde fuera de México?

Sí. Los precios y el cobro son en pesos mexicanos; tu banco hace la conversión al tipo de cambio del día.

¿Qué guardan de mis consultas?

Solo lo necesario para contar tu uso y revisar, de forma automática, que nadie lo use para copiar el catálogo: qué consulta hiciste (por ejemplo, qué código postal pediste) y si salió bien, sin lo que mandas aparte, como el nombre de una colonia o unas coordenadas. Esos registros se borran a los 30 días; después solo queda cuántas consultas hiciste en el mes. Tu dirección IP la usamos para proteger el servicio y la guardamos poco tiempo, solo por seguridad. El detalle está en el aviso de privacidad.

Tu próxima dirección,
sin errores de captura.

10,000 consultas al mes sin costo. Sin tarjeta. Haz tu primera consulta hoy.