Ir al contenido

Versión del dato, fuente y totales

GET/v1/metaTodos los planes

¿Qué hace?

La versión vigente del dato, la fecha de cada fuente y los totales del catálogo. Úsalo para saber si hay una versión nueva antes de actualizar tu copia.

La petición

No lleva parámetros.

Ejemplo

curl -H "x-api-key: TU_LLAVE" "https://colonix.silgaru.mx/v1/meta"

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.

200 OK
{
"data_version": "2026.11.05-36a7823b",
"generated_at": "2026-11-09T12:31:13.062698+00:00",
"history_since": "2026-10-05",
"sat_history_since": "2026-01-22",
"schema_version": "6",
"source": "sepomex",
"source_date": "2026-11-05T00:16:46",
"sources": {
"geography": {
"localities_attribution": "Fuente: INEGI, Catálogo Único de Claves Geoestadísticas",
"localities_date": "2017-02-28",
"polygons_attribution": "Servicio Postal Mexicano (SEPOMEX), datos.gob.mx, CC-BY-4.0",
"polygons_date": "2026-01-05"
},
"metro_areas": {
"attribution": "Las metrópolis de México 2020: SEDATU, CONAPO e INEGI; publicado por CONAPO en datos.gob.mx, CC-BY-4.0",
"delimitation": "2020"
},
"sat": {
"file": "catCFDI_V_4_20261029.xls",
"postal_codes": "8",
"settlements": "0",
"settlements_revised": false,
"published": "2026-01-22"
},
"sepomex": {
"date": "2026-11-05T00:16:46"
}
},
"totals": {
"metro_area_municipalities": 421,
"metro_areas": 92,
"municipalities": 2478,
"postal_code_polygons": 35898,
"postal_codes": 31868,
"sat_postal_codes": 95748,
"sat_settlements": 145366,
"settlement_types": 24,
"settlements": 159462,
"states": 32
}
}

Campos

CampoTipoDescripción
data_versiontextoVersión del dato
history_sincefechaFecha de la primera versión del dato registrada: el as_of más antiguo en /v1/postal-codes/{code}
sat_history_sincefecha o nullFecha de publicación de la primera revisión registrada del catálogo del SAT: el as_of más antiguo en /v1/sat/postal-codes/{code} (null si no hay ninguna registrada)
sourcesno siempre vieneobjetoVersión de cada fuente
sources.sepomexno siempre vieneobjeto
sources.satno siempre vieneobjetoVersión del archivo de catálogos del SAT que se usó.
sources.geographyno siempre vieneobjetoFechas y atribución de las fuentes geográficas
sources.metro_areasno siempre vieneobjetoFuente de las zonas metropolitanas
sourcetextoFuente del dato
source_datetextoFecha del archivo fuente
generated_atfecha y horaFecha de construcción
schema_versiontextoVersión del esquema del snapshot
totalsobjetoConteos de registros (settlements, postal_codes, states, municipalities, settlement_types, postal_code_polygons...)

Errores

Todos en formato application/problem+json; ninguno cuenta para tu cuota. Qué hacer con cada uno: Errores.

EstadoCuándo
401Credenciales faltantes (/errors/missing-api-key) o inválidas (/errors/invalid-api-key).
403Llave suspendida (/errors/api-key-suspended) o endpoint fuera de tu plan (/errors/plan-not-allowed).
429Se 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.
5XXError 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.