GEThttps://api.veriko.mx/v1/validations/{id}/retry-attempts

List retry attempts

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

Returns the chronological history of a validation's automatic retries.

Each entry identifies the attempt, its timestamps, the statuses before and after, and the error when there was one.

The criteria that trigger these attempts are described in the retry policy.

Parameters
Parameter	In	Type	Required	Description
`id`*	path	`string (uuid)`	required	Validation UUID.

Request

cURLPython•JavaScript•PHP•

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

Python example — coming soon.

JavaScript example — coming soon.

PHP example — coming soon.

**Response 200**`RetryAttempt` — List of retry attempts in chronological order by ascending `attempt_number`.
Field	Type	Description
`attempt_number`	`integer`	Attempt position in the cycle, starting at `1`. e.g. `1`
`dispatched_at`	`string (date-time)`	ISO 8601 timestamp in UTC with an explicit `Z` suffix; for example, `"2026-05-01T05:14:38Z"`. The `_at`, `_end`, `_start`, and `_date` fields follow this format. `meta.datetime` describes the same contract in the response. e.g. `2026-05-01T05:14:38Z`
`started_at`	`string (date-time)`	ISO 8601 timestamp in UTC with an explicit `Z` suffix; for example, `"2026-05-01T05:14:38Z"`. The `_at`, `_end`, `_start`, and `_date` fields follow this format. `meta.datetime` describes the same contract in the response. e.g. `2026-05-01T05:14:38Z`
`finished_at`	`string (date-time)`	ISO 8601 timestamp in UTC with an explicit `Z` suffix; for example, `"2026-05-01T05:14:38Z"`. The `_at`, `_end`, `_start`, and `_date` fields follow this format. `meta.datetime` describes the same contract in the response. e.g. `2026-05-01T05:14:38Z`
`prev_banxico_status`	`string`	Banxico verdict before the attempt. e.g. `not_found`
`new_banxico_status`	`string \| null`nullable	Banxico verdict obtained by the attempt; `null` when there was no response. e.g. `valid`
`prev_status`	`string`	Validation state before the attempt. e.g. `not_found`
`new_status`	`string \| null`nullable	Validation state after the attempt; `null` when there was no transition. e.g. `valid`
`processing_time_ms`	`integer \| null`nullable	Processing time for the attempt in milliseconds. `null` when the attempt did not complete. e.g. `1250`
`error_code`	`ValidationErrorCode \| null`	Error code produced by the attempt; `null` when there was no error. e.g. `network`
`proxy_pool_member`	`string \| null`nullable	Identifier of the outbound route used to query Banxico. e.g. `proxy-03`

**Response status codes**`GET /v1/validations/{id}/retry-attempts`
Status	Class	Description	Body
200	`2xx`	List of retry attempts in chronological order by ascending `attempt_number`.	`RetryAttempt`
401	`4xx`	Authentication is required or the provided credentials are invalid.	`ErrorResponse`
403	`4xx`	Insufficient permissions.	`ErrorResponse`
404	`4xx`	Validation not found (`not_found`).	`ErrorResponse`
410	`4xx`	The validation was purged and this resource no longer exists (`validation_purged`).	`ErrorResponse`
422	`4xx`	Invalid UUID in path (`invalid_uuid`).	`ErrorResponse`

**Errors from `GET /v1/validations/{id}/retry-attempts`**
Status	Code	Example
401	`unauthorized`	Invalid or missing authentication credentials. Envelope meta.request_id `c4d5e6f7a8b99b8a7f6e5d4c`
403	`permission_denied`	You do not have permission to access this resource. Envelope meta.request_id `d5e6f7a8b9c00c9b8a7f6e5d`
410	`validation_purged`	The validation was purged and this resource no longer exists. Envelope meta.request_id `1a2b3c4d5e6ff6e5d4c3b2a1`