Listar intentos de reintento

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

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

Devuelve todos los reintentos automáticos que se han hecho sobre una validación, en orden. Cada entrada trae las marcas de tiempo del despacho, el inicio y el fin, el veredicto antes y después del intento, cuánto tardó y el código de error si lo hubo. Sirve para entender por qué una validación acabó donde acabó: la política que gobierna esos intentos está en la política de reintentos.

Parámetros
Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`id`*	path	`string (uuid)`	obligatorio	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 (ASC por attempt_number).
Campo	Tipo	Descripción
`attempt_number`	`integer`	Número de secuencia del intento (1-based). p. ej. `1`
`dispatched_at`	`string (date-time)`	Timestamp ISO 8601 en UTC con sufijo `Z` explícito. Ejemplo: `"2026-05-01T05:14:38Z"`. Cada campo `_at`, `_end`, `_start`, `_date` de la API usa esta forma. El descriptor compañero en `meta.datetime` permite afirmar el contrato en tiempo de ejecución sin volver a leer este spec. El `new Date(value)` nativo del navegador, el `datetime.fromisoformat` (≥3.11) de Python y el `time.Parse(time.RFC3339)` de Go parsean este formato directamente. p. ej. `2026-05-01T05:14:38Z`
`started_at`	`string (date-time)`	Timestamp ISO 8601 en UTC con sufijo `Z` explícito. Ejemplo: `"2026-05-01T05:14:38Z"`. Cada campo `_at`, `_end`, `_start`, `_date` de la API usa esta forma. El descriptor compañero en `meta.datetime` permite afirmar el contrato en tiempo de ejecución sin volver a leer este spec. El `new Date(value)` nativo del navegador, el `datetime.fromisoformat` (≥3.11) de Python y el `time.Parse(time.RFC3339)` de Go parsean este formato directamente. p. ej. `2026-05-01T05:14:38Z`
`finished_at`	`string (date-time)`	Timestamp ISO 8601 en UTC con sufijo `Z` explícito. Ejemplo: `"2026-05-01T05:14:38Z"`. Cada campo `_at`, `_end`, `_start`, `_date` de la API usa esta forma. El descriptor compañero en `meta.datetime` permite afirmar el contrato en tiempo de ejecución sin volver a leer este spec. El `new Date(value)` nativo del navegador, el `datetime.fromisoformat` (≥3.11) de Python y el `time.Parse(time.RFC3339)` de Go parsean este formato directamente. p. ej. `2026-05-01T05:14:38Z`
`prev_banxico_status`	`string`	Estado Banxico de la validación inmediatamente antes de este intento (p.ej. `not_found`). Los veredictos son `valid`, `not_found`, `cep_unavailable`, `invalid` y `error`. p. ej. `not_found`
`new_banxico_status`	`string \| null`anulable	Estado Banxico tras completar el intento. `null` si el intento no obtuvo respuesta de Banxico (p.ej. fallo de red). Los veredictos son `valid`, `not_found`, `cep_unavailable`, `invalid` y `error`. p. ej. `valid`
`prev_status`	`string`	Estado de la validación antes del intento. Los estados son `queued`, `processing`, `valid`, `not_found`, `cep_unavailable`, `invalid`, `failed` y `error`. p. ej. `not_found`
`new_status`	`string \| null`anulable	Estado de la validación tras el intento. `null` si el intento no produjo transición de estado. Los estados son `queued`, `processing`, `valid`, `not_found`, `cep_unavailable`, `invalid`, `failed` y `error`. p. ej. `valid`
`processing_time_ms`	`integer \| null`anulable	Tiempo de procesamiento del intento en milisegundos. `null` si el intento no completó. p. ej. `1250`
`error_code`	`ValidationErrorCode \| null`	Código de error si el intento terminó en fallo. Ver `ValidationErrorCode` para los valores posibles. `null` si el intento completó sin error. p. ej. `network`
`proxy_pool_member`	`string \| null`anulable	Identificador del proxy utilizado en este intento. Útil para diagnóstico de fallos repetidos en el mismo nodo. 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 (ASC por attempt_number).	Sin cuerpo
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`
422	`4xx`	UUID inválido en el path (`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 `c4d5e6f7a8b9`
403	`forbidden`	No tienes permiso para acceder a este recurso. Envelope meta.request_id `d5e6f7a8b9c0`