GEThttps://api.veriko.mx/v1/finance/ceps

Descargar los comprobantes en un archivo comprimido

Audiencia: public
Autenticación: API key
Permiso: finance:download

Entrega en un solo ZIP todos los archivos CEP disponibles de un rango de fechas.

Cada validación con comprobante aporta su archivo XML y PDF (si está disponible), todo bajo el directorio ceps/. El archivo trae dos manifiestos con el mismo contenido en distinto formato — manifest.csv y manifest.xlsx: Que asocian cada comprobante con su validación, fecha y clave de rastreo. Sirven para conciliar sin abrir los comprobantes uno por uno.

Un rango sin comprobantes responde con un estado HTTP 404 no_ceps.

Fechas mal formadas o un to anterior al from, responden con un estado HTTP 400 invalid_range.

Parámetros
Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`from`*	query	`string (date)`	obligatorio	Fecha de inicio (inclusive, `YYYY-MM-DD`). p. ej. `2026-04-01`
`to`*	query	`string (date)`	obligatorio	Fecha de fin (inclusive, `YYYY-MM-DD`). Debe ser ≥ `from`. p. ej. `2026-04-30`
`user_id`	query	`string (uuid)`	opcional	Solo para administradores — UUID del usuario a consultar. p. ej. `f47ac10b-58cc-4372-a567-0e02b2c3d479`

Petición

cURLPython•JavaScript•PHP•

curl -X GET 'https://api.veriko.mx/v1/finance/ceps' \
  -H 'Authorization: Bearer veriko_••••'

Ejemplo en Python — próximamente.

Ejemplo en JavaScript — próximamente.

Ejemplo en PHP — próximamente.

**Códigos de respuesta**`GET /v1/finance/ceps`
Código	Clase	Descripción	Cuerpo
200	`2xx`	ZIP con los XML/PDF de CEP y los manifiestos CSV + XLSX.	Cuerpo sin schema
400	`4xx`	`invalid_range`: Fechas mal formadas o `to < from`.	`ErrorResponse`
401	`4xx`	Se requiere autenticación o las credenciales son inválidas	`ErrorResponse`
403	`4xx`	Permisos insuficientes	`ErrorResponse`
404	`4xx`	`no_ceps`: El rango no contiene ningún CEP disponible.	`ErrorResponse`

**Cabeceras de respuesta**`200`
Cabecera	Tipo	Descripción
`Cache-Control`	`string`	Deshabilita el almacenamiento en caché por parte de intermediarios durante la descarga.
`Content-Disposition`	`string`	Nombre de archivo sugerido para la descarga.
`Content-Length`	`integer`	Tamaño exacto del ZIP en bytes.
`Content-Type`	`string`
`X-Finance-Items`	`integer`	Número de CEPs incluidos en el ZIP.

**Errores de `GET /v1/finance/ceps`**
Código	Clave	Ejemplo
401	`unauthorized`	Credenciales de autenticación ausentes o inválidas. Envelope meta.request_id `c4d5e6f7a8b99b8a7f6e5d4c`
403	`permission_denied`	No tienes permiso para acceder a este recurso. Envelope meta.request_id `d5e6f7a8b9c00c9b8a7f6e5d`