Download the official CEP

GEThttps://api.veriko.mx/v1/validations/{id}/cep

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

Downloads the Comprobante Electrónico de Pago that Banxico issues for an already validated transfer. It only exists when the validation ended in banxico_status: 'valid', which is the same as has_cep: true; in any other case the response is 404 cep_not_available. The default format is XML. With ?format=pdf the result is the Banxico-signed PDF, which is the one that serves as proof to third parties. For a whole date range there is a better route than calling here once per validation: GET /v1/finance/ceps returns every CEP in the period in a single ZIP, with its manifests. Which validations have a CEP available is known by filtering GET /v1/validations by status=valid.

Parameters
Parameter	In	Type	Required	Description
`id`*	path	`string (uuid)`	required	Validation UUID.
`format`	query	`string`	optional	Certificate format: `xml` (default) or `pdf`. Default: `xml` e.g. `xml`

Request

cURLPython•JavaScript•PHP•

curl -X GET 'https://api.veriko.mx/v1/validations/{id}/cep' \
  -H 'Authorization: Bearer veriko_••••'

Python example — coming soon.

JavaScript example — coming soon.

PHP example — coming soon.

**Response status codes**`GET /v1/validations/{id}/cep`
Status	Class	Description	Body
200	`2xx`	CEP certificate file. `Content-Type` is `application/xml` or `application/pdf` based on the requested format.	No body
400	`4xx`	Format outside the allowlist (`invalid_export_format`).	`ErrorResponse`
401	`4xx`	Authentication is required or the provided credentials are invalid.	`ErrorResponse`
403	`4xx`	Insufficient permissions.	`ErrorResponse`
404	`4xx`	Validation not found (`not_found`) or the CEP is not available for this validation (`cep_not_available`). The CEP is not emitted when `banxico_status` is not `valid`, or when the associated XML/PDF was not persisted.	`ErrorResponse`
422	`4xx`	Invalid UUID in path (`invalid_uuid`).	`ErrorResponse`

**Response headers**`200`
Header	Type	Description
`Content-Disposition`	`string`	Force download with filename `CEP-{validation_id}.{ext}`.

**Errors from `GET /v1/validations/{id}/cep`**
Status	Code	Example
401	`unauthorized`	Invalid or missing authentication credentials. Envelope meta.request_id `c4d5e6f7a8b9`
403	`forbidden`	You do not have permission to access this resource. Envelope meta.request_id `d5e6f7a8b9c0`