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

Listar intentos de reintento

Audiencia: public
Autenticación: API key
Permiso: validations:read

Devuelve el historial cronológico de los reintentos automáticos de una validación.

Cada entrada identifica el intento, sus tiempos, los estados anterior y posterior, y el error cuando lo hubo.

Los criterios que originan estos intentos están descritos en la política de reintentos.

Parámetros
Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`id`*	path	`string (uuid)`	obligatorio	Identificador (UUID) de la validación

Petición

cURLPython•JavaScript•PHP•

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

Ejemplo en Python — próximamente.

Ejemplo en JavaScript — próximamente.

Ejemplo en PHP — próximamente.

**Respuesta 200**`RetryAttempt` — Lista de intentos de reintento ordenada cronológicamente por `attempt_number` ascendente.
Campo	Tipo	Descripción
`attempt_number`	`integer`	Posición del intento en el ciclo, comenzando en `1`. p. ej. `1`
`dispatched_at`	`string (date-time)`	Timestamp ISO 8601 en UTC con sufijo `Z` explícito; por ejemplo, `"2026-05-01T05:14:38Z"`. Los campos `_at`, `_end`, `_start` y `_date` adoptan esta forma. `meta.datetime` describe el mismo contrato en la respuesta. p. ej. `2026-05-01T05:14:38Z`
`started_at`	`string (date-time)`	Timestamp ISO 8601 en UTC con sufijo `Z` explícito; por ejemplo, `"2026-05-01T05:14:38Z"`. Los campos `_at`, `_end`, `_start` y `_date` adoptan esta forma. `meta.datetime` describe el mismo contrato en la respuesta. p. ej. `2026-05-01T05:14:38Z`
`finished_at`	`string (date-time)`	Timestamp ISO 8601 en UTC con sufijo `Z` explícito; por ejemplo, `"2026-05-01T05:14:38Z"`. Los campos `_at`, `_end`, `_start` y `_date` adoptan esta forma. `meta.datetime` describe el mismo contrato en la respuesta. p. ej. `2026-05-01T05:14:38Z`
`prev_banxico_status`	`string`	Veredicto de Banxico anterior al intento. p. ej. `not_found`
`new_banxico_status`	`string \| null`anulable	Veredicto de Banxico obtenido en el intento; `null` cuando no hubo respuesta. p. ej. `valid`
`prev_status`	`string`	Estado de la validación antes del intento. p. ej. `not_found`
`new_status`	`string \| null`anulable	Estado de la validación después del intento; `null` cuando no hubo transición. p. ej. `valid`
`processing_time_ms`	`integer \| null`anulable	Tiempo de procesamiento del intento (en milisegundos). `null` cuando el intento no completó. p. ej. `1250`
`error_code`	`ValidationErrorCode \| null`	Código del error producido por el intento; `null` cuando no hubo error. p. ej. `network`
`proxy_pool_member`	`string \| null`anulable	Identificador de la ruta de salida por la que se consultó a Banxico. p. ej. `proxy-03`

**Códigos de respuesta**`GET /v1/validations/{id}/retry-attempts`
Código	Clase	Descripción	Cuerpo
200	`2xx`	Lista de intentos de reintento ordenada cronológicamente por `attempt_number` ascendente.	`RetryAttempt`
401	`4xx`	Se requiere autenticación o las credenciales son inválidas	`ErrorResponse`
403	`4xx`	Permisos insuficientes	`ErrorResponse`
404	`4xx`	Validación no encontrada (`not_found`).	`ErrorResponse`
410	`4xx`	La validación se purgó y este recurso ya no existe (`validation_purged`).	`ErrorResponse`
422	`4xx`	UUID inválido en la ruta (`invalid_uuid`).	`ErrorResponse`

**Errores de `GET /v1/validations/{id}/retry-attempts`**
Código	Clave	Ejemplo
401	`unauthorized`	Credenciales de autenticación ausentes o inválidas. Envelope meta.request_id `c4d5e6f7a8b99b8a7f6e5d4c`
403	`permission_denied`	No tienes permiso para acceder a este recurso. Envelope meta.request_id `d5e6f7a8b9c00c9b8a7f6e5d`
410	`validation_purged`	La validación se purgó y este recurso ya no existe. Envelope meta.request_id `1a2b3c4d5e6ff6e5d4c3b2a1`