Saltar al contenido

Actualizaciones del catálogo: cada revisión, con fecha

El catálogo oficial trae una sola fecha de actualización y ningún historial, así que no hay manera de distinguir una versión que no cambió nada de una versión que se te pasó. Esta página es el registro de la copia que sirve PostalKit: un renglón por ejecución, incluidos los meses en que la fuente no se movió.

Última revisión
2026-08-14
Último cambio
2026-08-14

Cómo se mantiene al día el catálogo

  • Se revisa el primero de cada mes.

    Una tarea programada descarga el catálogo publicado a las 03:00 y lo compara con la copia ya importada.

  • Se compara por hash, no por fecha.

    La comparación es un SHA-256 del archivo descargado. Si coincide, no se importa nada y nada se mueve, así que una diferencia en los datos siempre significa que la fuente cambió de verdad.

  • Se concilia, no solo se acumula.

    Una colonia que el servicio postal da de baja también se da de baja aquí, así que lo que lees es el catálogo vigente y no todo lo que alguna vez estuvo en él.

  • Los identificadores no se mueven.

    Una actualización empata por código postal y por clave INEGI en lugar de recargar el catálogo desde cero, así que los ids que guardaste el mes pasado siguen resolviendo este mes.

El historial

Cada ejecución, de la más reciente a la más antigua. También aparece la que encontró la fuente sin cambios: esa es la diferencia entre un catálogo que se revisó y uno que simplemente se dejó quieto.

Actualizaciones del catálogo, de la más reciente a la más antigua
Ejecución Resultado Códigos postales Colonias Municipios Ciudades Estados
2026-08-14 Actualizado

Se leen como agregados, modificados y dados de baja. Un guion significa que esa ejecución es anterior a este historial y su detalle nunca se registró.

Qué significa realmente un cambio

  • Un cambio de nombre aparece dos veces.

    Una colonia se identifica por su nombre dentro de un código postal, así que renombrarla da de baja la entrada anterior y agrega la nueva. Un mes con altas y bajas parejas suele ser el servicio postal corrigiendo la escritura.

  • Una fila modificada es un campo modificado.

    El número de en medio cuenta las colonias cuya zona pasó entre urbano, rural y semiurbano. Una actualización que vuelve a leer una fila sin alterarla no se cuenta.

  • Un mes sin novedades también es una respuesta.

    El servicio postal no publica con una periodicidad fija. Que varias revisiones seguidas no encuentren nada es normal, y por eso la revisión se registra aparte del cambio.

Desde tu propio código

Pregúntale a la API qué versión estás leyendo

El mismo dato está a una petición de distancia, así que un despliegue puede decidir por su cuenta si vale la pena volver a sincronizar:

GET /v1/account/db-version

Responde con las dos fechas:

{
    "data": {
        "last_updated": "2026-08-01T03:00:00.000000Z",
        "catalog_version": "2026-08-01",
        "last_checked_at": "2026-09-01T03:00:00.000000Z",
        "version": "1.0.0"
    }
}

last_checked_at avanza cada mes haya cambiado o no el catálogo, así que un last_updated que lleva meses sin moverse significa que la fuente oficial no se ha movido, no que algo haya dejado de correr.

códigos postales
31,880
códigos postales
colonias
159,019
colonias
municipios
2,478
municipios
estados
32
estados

De dónde viene este catálogo, y qué te deja por resolver la exportación oficial, está en la guía del catálogo SEPOMEX. El endpoint de arriba está documentado en la referencia de API.

Lee un catálogo que se mantiene solo.

Se revisa el primero de cada mes, se concilia en lugar de acumularse, y queda fechado para que puedas comprobarlo. El plan gratuito son 100 consultas al mes, sin tarjeta.

curl -s https://api.postalkit.mx/v1/account/db-version -H "Authorization: Bearer YOUR_API_KEY"