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

Bulk CEP download (ZIP)

Audience: public
Auth: API key
Permission: finance:download

Delivers every available CEP file in a date range as a single ZIP.

Each validation with a receipt contributes its XML and PDF file (when available), all under the ceps/ directory. The archive carries two manifests with the same content in different formats — manifest.csv and manifest.xlsx: Associating each receipt with its validation, date and tracking key. They serve to reconcile without opening the receipts one by one.

A range with no receipts responds with an HTTP status 404 no_ceps.

Malformed dates, or a to earlier than the from, respond with an HTTP status 400 invalid_range.

Parameters
Parameter	In	Type	Required	Description
`from`*	query	`string (date)`	required	Start date (inclusive, `YYYY-MM-DD`). e.g. `2026-04-01`
`to`*	query	`string (date)`	required	End date (inclusive, `YYYY-MM-DD`). Must be ≥ `from`. e.g. `2026-04-30`
`user_id`	query	`string (uuid)`	optional	Administrators only — UUID of the user to query. e.g. `f47ac10b-58cc-4372-a567-0e02b2c3d479`

Request

cURLPython•JavaScript•PHP•

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

Python example — coming soon.

JavaScript example — coming soon.

PHP example — coming soon.

**Response status codes**`GET /v1/finance/ceps`
Status	Class	Description	Body
200	`2xx`	ZIP archive containing CEP XML/PDF files and CSV + XLSX manifests.	Body without schema
400	`4xx`	`invalid_range`: Malformed dates or `to < from`.	`ErrorResponse`
401	`4xx`	Authentication is required or the provided credentials are invalid.	`ErrorResponse`
403	`4xx`	Insufficient permissions.	`ErrorResponse`
404	`4xx`	`no_ceps`: No CEPs available in the specified range.	`ErrorResponse`

**Response headers**`200`
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.

**Errors from `GET /v1/finance/ceps`**
Status	Code	Example
401	`unauthorized`	Invalid or missing authentication credentials. Envelope meta.request_id `c4d5e6f7a8b99b8a7f6e5d4c`
403	`permission_denied`	You do not have permission to access this resource. Envelope meta.request_id `d5e6f7a8b9c00c9b8a7f6e5d`