https://api.veriko.mx/v1/validations/imports/{id}/preview Get parsed rows
Lists all rows extracted from the uploaded file, with their parsed fields, assigned bucket, and any error codes. Filterable by one or more buckets via buckets[]. The response is NOT paginated — the full list is returned (bounded by the job's total_rows). Cookie-only endpoint: API key callers receive 401.
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
id * | path | integer | required | Numeric ID of the import job. |
buckets[] | query | array<string> | optional | Filter by one or more buckets. If omitted or all values are invalid, returns all rows of the job. |
curl -X GET 'https://api.veriko.mx/v1/validations/imports/{id}/preview' \
-H 'Authorization: Bearer mxcep_••••'
Python example — coming soon.
JavaScript example — coming soon.
PHP example — coming soon.
| Field | Type | Description |
|---|---|---|
type | string | JSON:API resource type (always `validation_import_row`). |
id | string | Numeric row ID as a string (JSON:API convention). |
attributes | object | Parsed row attributes. |
row_index | integer | 0-based index of the row within the original file. |
status | string | Row lifecycle state: `pending_ocr` = awaiting OCR; `valid` = complete data ready to commit; `correctable` = incomplete data the user can edit; `fatal` = invalid data that cannot be corrected; `duplicate` = duplicated within the batch; `queued` = dispatched to stream after commit; `processing` = actively being processed; `validated_valid` / `validated_not_found` / `validated_invalid` / `validated_cep_unavailable` / `validated_error` = final Banxico result; `skipped` = skipped; `cancelled` = cancelled by the user. |
parsed_clave_rastreo | string | null nullable | SPEI tracking key extracted from the file. null if it could not be extracted. |
parsed_referencia_numerica | string | null nullable | Numeric payment reference extracted from the file. `null` if it could not be extracted. |
parsed_fecha | string | null nullable | Transaction date in `YYYY-MM-DD` format (normalized during parsing). `null` if it could not be extracted. |
parsed_monto | number | null nullable (> 0) | Transaction amount in MXN pesos. `null` if it could not be extracted. |
parsed_cuenta_beneficiaria | string | null nullable | Beneficiary account extracted: 18-digit CLABE, debit card number, or 10-digit mobile number (DiMo). `null` if it could not be extracted. |
parsed_emisor | string | null nullable | 4-5 digit SPEI code of the issuing bank, resolved from the account or bank name. `null` if it could not be resolved. |
parsed_receptor | string | null nullable | 4-5 digit SPEI code of the receiving bank, resolved from the account or bank name. `null` if it could not be resolved. |
error_codes | array | null nullable | Local parse error codes (e.g. `clabe_checksum_failed`, `fecha_missing`). null if the row has no errors. |
corrections_applied | array | null nullable | Warnings for corrections applied during normalization (e.g. receiving bank inferred from CLABE prefix). null if no corrections were applied. |
user_overrides | object | null nullable | Fields overridden by the user in the preview (via PATCH). Values here take precedence over parsed fields at commit time. null if no overrides. |
validation_id | string | null nullable | UUID of the validation record created in the `validations` table after commit. `null` before commit or if the row was skipped. |
| Status | Class | Description | Body |
|---|---|---|---|
| 200 | 2xx | Preview rows with totals and job metadata. | No body |
| 401 | 4xx | No active session OR API key call (cookie-only). | ErrorResponse |
| 404 | 4xx | Job not found or not owned by the user (`not_found`). | ErrorResponse |
| Status | Code | Detail |
|---|