https://api.veriko.mx/v1/validations/imports Start a bulk validations import
Upload one or more files to validate multiple transfers against Banxico CEP in the background. Modes:
text+template: CSV / XLSX / XLS / TXT / JSON file with canonical headers (ES or EN).text+free: free-form TXT / CSV; the system applies a per-line regex sweep with no AI escalation.images: PNG / JPG / WEBP (single or multi-select asfile[]) or a ZIP of images; each image goes through the canonical OCR and normalization pipeline. Multi-selects are packed server-side into a tmp ZIP.
Only one batch may be in flight per user (import_already_in_flight when one is already active). The job returns status pending immediately; use GET /v1/validations/imports/{id} to poll progress. Cookie-only endpoint: API key callers receive 401.
curl -X POST 'https://api.veriko.mx/v1/validations/imports' \
-H 'Authorization: Bearer mxcep_••••' \
-H 'Content-Type: application/json'
Python example — coming soon.
JavaScript example — coming soon.
PHP example — coming soon.
| Field | Type | Description |
|---|---|---|
status | string | Initial status of the freshly created import (`pending` until the user confirms the commit). |
| Status | Class | Description | Body |
|---|---|---|---|
| 201 | 2xx | Job created in `pending` state. Parsing starts async. | No body |
| 401 | 4xx | No active session OR API key call (this endpoint requires cookie authentication). | ErrorResponse |
| 409 | 4xx | A batch is already in flight for this user. Wait for it to finish or cancel it before starting a new one (`import_already_in_flight`). | ErrorResponse |
| 422 | 4xx | Upload validation failed. Codes: `file_required` (no file), `multi_upload_not_allowed_for_text` (multi-file with upload_type=text), `zip_pack_failed` (internal ZIP pack failed), `upload_error_<N>` (PHP UPLOAD_ERR_* codes), `file_too_large`, `unsupported_format`, `persist_failed`. | ErrorResponse |
| Status | Code | Detail |
|---|