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

Bulk CEP download (ZIP)

Audience
public
Auth
API key
Permission
finance:download
How-to guide →

Delivers every available CEP in a date range as a single ZIP. Each validation with a receipt contributes its XML, and those that also have the signed PDF include it too, under ceps/. The archive carries two manifests with the same content in different formats — manifest.csv and manifest.xlsx — associating each receipt with its validation, its date, and its tracking key. They are there for reconciling without opening the receipts one by one. A range with no receipts responds 404 no_ceps; malformed dates, or a to earlier than the from, respond 400 invalid_range. This endpoint requires the finance:download permission, not finance:generate_self. The distinction is deliberate: the financial reports describe the activity, whereas here the receipts themselves are handed over. For a single receipt there is GET /v1/validations/{id}/cep, and for the month's statement without the files, GET /v1/finance/statement.

Parameters
ParameterInTypeRequiredDescription
from*querystring (date)required

Start date (inclusive, YYYY-MM-DD).

e.g. 2026-04-01
to*querystring (date)required

End date (inclusive, YYYY-MM-DD). Must be ≥ from.

e.g. 2026-04-30
user_idquerystring (uuid)optional

Admin-only with finance:generate_all. UUID of the user to query.

e.g. f47ac10b-58cc-4372-a567-0e02b2c3d479
Request
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 codesGET /v1/finance/ceps
StatusClassDescriptionBody
2002xxZIP archive containing CEP XML/PDF files and CSV + XLSX manifests.No body
4004xxinvalid_range — malformed dates or to < from.ErrorResponse
4014xxAuthentication is required or the provided credentials are invalid.ErrorResponse
4034xxInsufficient permissions.ErrorResponse
4044xxno_ceps — no CEPs available in the specified range.ErrorResponse
Response headers200
HeaderTypeDescription
Cache-ControlstringDisables intermediary caching of the download.
Content-DispositionstringSuggested filename for the download.
Content-LengthintegerExact size of the ZIP archive in bytes.
Content-Typestring
X-Finance-ItemsintegerNumber of CEPs included in the ZIP archive.
Errors from GET /v1/finance/ceps
StatusCodeExample
401unauthorized

Invalid or missing authentication credentials.

Envelope
meta.request_id
c4d5e6f7a8b9
403forbidden

You do not have permission to access this resource.

Envelope
meta.request_id
d5e6f7a8b9c0