Export validations

GEThttps://api.veriko.mx/v1/validations/export

Export validations

Audience: public
Auth: API key
Permission: validations:read

Downloads the validation history as a file, under the same filters as GET /v1/validations: what the list shows is what the file contains. The format is chosen with ?format: csv by default, xlsx as the alternative. The cap is 100,000 rows and ?limit asks for fewer, never more. The file name carries the brand and the period's date.

Parameters
Parameter	In	Type	Required	Description
`amount_max`	query	`number (float)`	optional	Inclusive maximum amount. Compared against the validation's `monto` (normalized_data, falling back to request_data). Independent of `amount_min`. e.g. `50000`
`amount_min`	query	`number (float)`	optional	Inclusive minimum amount. Compared against the validation's `monto` (normalized_data, falling back to request_data). Independent of `amount_max`. e.g. `1000.5`
`bank`	query	`string`	optional	Filter by the bank's 3-digit SPEI code (receiver or sender). Digits only, max 5 characters; any other value is ignored. e.g. `012`
`batch_id`	query	`integer`	optional	Filters to validations belonging to a bulk import job. e.g. `42`
`format`	query	`string`	optional	File format: `csv` (default) or `xlsx`. Default: `csv` e.g. `csv`
`from`	query	`string (date)`	optional	Inclusive start date (YYYY-MM-DD). e.g. `2025-01-01`
`limit`	query	`integer`	optional	Trims the number of rows in the file. It only lowers the cap: a value above 100,000, or below 1, leaves the default cap in place. e.g. `500`
`playground`	query	`string`	optional	Keeps only validations made from the playground. The only accepted value is `1`: anything else — `true` included — answers `422` rather than being ignored, so it is clear the filter was not applied. e.g. `1`
`retry_state`	query	`string`	optional	State of the validation's automatic retries. `pending` has an attempt ahead. `resolved` ended up finding the receipt. `exhausted` used up its attempts without success, and `cancelled` was stopped on request. Only validations that ended in `not_found`, `cep_unavailable`, or `error` get retries; the rest carry no value here. e.g. `pending`
`search`	query	`string`	optional	Search across tracking key, reference, sender, and recipient. e.g. `MXBA20250315001234`
`status`	query	`string`	optional	The state the validation ended in. `queued` and `processing` have not finished. `valid` found the receipt and it matches. `not_found` did not find it — most common when the transfer is very recent. `invalid` found it but the data does not match. `cep_unavailable` means Banxico could not answer, and `failed` or `error` mean the validation broke on our side. The distinction that matters most: `not_found` is a result, `cep_unavailable` is an outage. The first is not fixed by retrying right away; the second is. e.g. `valid`
`to`	query	`string (date)`	optional	Inclusive end date (YYYY-MM-DD). e.g. `2025-03-31`
`type`	query	`string`	optional	How the validation was requested: `direct` with the fields typed in, `ocr` from an image of the receipt. e.g. `direct`
`with_deleted`	query	`string`	optional	Whether to include deleted validations. `0` keeps only the live ones — the default — and `1` includes the deleted ones too. Deleted validations keep their result: they are what makes an already-exported history reconcile. e.g. `0`

Request

cURLPython•JavaScript•PHP•

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

Python example — coming soon.

JavaScript example — coming soon.

PHP example — coming soon.

**Response status codes**`GET /v1/validations/export`
Status	Class	Description	Body
200	`2xx`	CSV file (with UTF-8 BOM) or XLSX based on `format`. The filename is `<slug>_validaciones_<YYYY-MM-DD>.<ext>`, where `<slug>` identifies the deployment.	No body
401	`4xx`	Authentication is required or the provided credentials are invalid.	`ErrorResponse`
422	`4xx`	A filter carries a value outside its allowed list. The code is `invalid_filter` and the `detail` names the parameter.	`ErrorResponse`

**Response headers**`200`
Header	Type	Description
`Content-Disposition`	`string`	Download header with the canonical filename.

**Errors from `GET /v1/validations/export`**
Status	Code	Example
401	`unauthorized`	Invalid or missing authentication credentials. Envelope meta.request_id `c4d5e6f7a8b9`
422	`invalid_filter`	The `retry_state` filter has an unsupported value. Envelope meta.request_id `d4e5f6a1b2c3`