https://api.veriko.mx/v1/finance/ceps Bulk CEP download (ZIP)
How-to guide →Generates a ZIP archive with all available CEPs in the range. Each validation with cep_xml contributes ceps/cep_<id>.xml; those with cep_pdf_path also include ceps/cep_<id>.pdf (paths outside the storage/cep root are silently skipped for defense-in-depth). The ZIP includes manifest.csv (UTF-8 BOM with a [HEADER] section) and manifest.xlsx (rich version with freeze pane + autofilter) mapping each CEP to its validation_id, fecha, clave_rastreo, and files. Returns 404 no_ceps if the range is empty. Returns 400 invalid_range if dates are not YYYY-MM-DD or to < from. Accepts API key. Requires finance:download (NOT finance:generate_self). To download the CEP for a single validation use GET /v1/validations/{id}/cep; the monthly statement with KPIs (without the XML/PDF files) is GET /v1/finance/statement.
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
from * | query | string (date) | required | Start date (inclusive, `YYYY-MM-DD`). |
to * | query | string (date) | required | End date (inclusive, `YYYY-MM-DD`). Must be ≥ `from`. |
user_id | query | string (uuid) | optional | Admin-only with `finance:generate_all`. UUID of the user to query. |
curl -X GET 'https://api.veriko.mx/v1/finance/ceps' \
-H 'Authorization: Bearer mxcep_••••'
Python example — coming soon.
JavaScript example — coming soon.
PHP example — coming soon.
| Status | Class | Description | Body |
|---|---|---|---|
| 200 | 2xx | ZIP archive containing CEP XML/PDF files and CSV + XLSX manifests. | No body |
| 400 | 4xx | `invalid_range` — malformed dates or `to < from`. | ErrorResponse |
| 401 | 4xx | Authentication is required or the provided credentials are invalid. | ErrorResponse |
| 403 | 4xx | Permisos insuficientes | ErrorResponse |
| 404 | 4xx | `no_ceps` — no CEPs available in the specified range. | ErrorResponse |
| Header | Type | Description |
|---|---|---|
Cache-Control | string | Disables intermediary caching of the download. |
Content-Disposition | string | Suggested filename for the download. |
Content-Length | integer | Exact size of the ZIP archive in bytes. |
Content-Type | string | |
X-Finance-Items | integer | Number of CEPs included in the ZIP archive. |
| Status | Code | Detail |
|---|---|---|
| 401 | unauthorized | Invalid or missing authentication credentials. Envelope
|
| 403 | forbidden | You do not have permission to access this resource. Envelope
|