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

Listar intentos de reintento

Audiencia
public
Autenticación
API key
Permiso
validations:read
Guía de uso →

Devuelve el historial completo de intentos de reintento automático para una validación. Cada intento incluye marcas de tiempo (dispatched/started/ finished), el resultado obtenido (Banxico status pre/post), processing_time_ms y el código de error si lo hubo.

Parámetros
Parámetro Ubicación Tipo Obligatorio Descripción
id * path string (uuid) obligatorio

UUID de la validación

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

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).

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.

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.

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.

prev_banxico_status string

Estado Banxico de la validación inmediatamente antes de este intento (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).

prev_status string

Estado de la validación antes del intento.

new_status string | null anulable

Estado de la validación tras el intento. `null` si el intento no produjo transición de estado.

processing_time_ms integer | null anulable

Tiempo de procesamiento del intento en milisegundos. `null` si el intento no completó.

error_code string | null anulable

Código de error si el intento terminó en fallo. Ver `ValidationErrorCode` para los valores posibles. `null` si el intento completó sin error.

proxy_pool_member string | null anulable

Identificador del proxy utilizado en este intento. Útil para diagnóstico de fallos repetidos en el mismo nodo.

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 Detalle
401 unauthorized

Invalid or missing authentication credentials.

Envelope
meta.request_id
c4d5e6f7a8b9
403 forbidden

You do not have permission to access this resource.

Envelope
meta.request_id
d5e6f7a8b9c0