Listar entregas de todos los endpoints

GEThttps://api.veriko.mx/v1/webhooks/deliveries

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

Vista consolidada de todas las entregas de webhook del usuario autenticado, incluyendo los de todos sus endpoints. Soporta filtrado por estado, tipo de evento y rango de fechas.

Parámetros
Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`endpoint_id`	query	`string (uuid)`	opcional	Filtra por UUID de endpoint específico (igual que `/webhooks/{id}/deliveries`). p. ej. `7c9e6679-7425-40de-944b-e07fc1f90ae7`
`event_type`	query	`string`	opcional	Tipo de evento que originó la entrega. Del ciclo de una validación: `validation.completed` cuando termina bien, `validation.failed` cuando termina mal y `validation.error` cuando se rompe por nuestro lado. Y de sus reintentos automáticos: `validation.retry.scheduled` al programar uno, `validation.retry.resolved` cuando un reintento acaba encontrando el comprobante, y `validation.retry.exhausted` cuando se agotan sin lograrlo. De la suscripción: `billing.payment_succeeded` y `billing.payment_failed` por cada cobro, `billing.invoice_upcoming` antes de la siguiente factura, `billing.trial_will_end` antes de que acabe la prueba, y `billing.subscription_canceled` al cancelarse. p. ej. `validation.completed`
`page`	query	`integer`	opcional	Página que se pide, empezando en 1. Predeterminado: `1` p. ej. `1`
`per_page`	query	`integer`	opcional	Cuántas entregas trae cada página. Predeterminado: `50` p. ej. `50`
`status`	query	`string`	opcional	Desenlace del intento de entrega. `success` llegó. `failed` no llegó y ya no se reintenta. `retrying` falló pero queda algún intento. `pending` todavía no se ha intentado. p. ej. `failed`

Petición

cURLPython•JavaScript•PHP•

curl -X GET 'https://api.veriko.mx/v1/webhooks/deliveries' \
  -H 'Authorization: Bearer veriko_••••'

Ejemplo en Python — próximamente.

Ejemplo en JavaScript — próximamente.

Ejemplo en PHP — próximamente.

**Respuesta 200**`WebhookDelivery` — Lista consolidada de entregas de todos los endpoints del usuario.
Campo	Tipo	Descripción
`type`*	`string`	Tipo del recurso, fijo para esta operación. Forma parte de la identidad del recurso en la envoltura JSON:API. Siempre `webhook_delivery`. p. ej. `webhook_delivery`
`id`*	`string`	Identificador autoincremental de la entrega. p. ej. `48211`
`attributes`*	`object`	Atributos canónicos de la entrega del webhook (endpoint receptor, intento, respuesta y estado).
`endpoint_id`	`string (uuid)`	UUID del endpoint de webhook que originó esta entrega. p. ej. `a1b2c3d4-e5f6-7890-abcd-ef0123456789`
`endpoint_url`	`string`	URL del endpoint receptor. Solo presente en la lista cross-endpoint (`GET /webhooks/deliveries`). p. ej. `https://erp.example.com/hooks/pagos`
`event_type`	`string`	Tipo de evento que disparó la entrega. Determina la forma del cuerpo firmado con HMAC que se envía al receptor. Los eventos son `validation.completed`, `validation.failed`, `validation.error`, `validation.retry.scheduled`, `validation.retry.resolved`, `validation.retry.exhausted`, `billing.payment_succeeded`, `billing.payment_failed`, `billing.trial_will_end`, `billing.subscription_canceled` y `billing.invoice_upcoming`. p. ej. `validation.completed`
`validation_id`	`string \| null`anulable	UUID de la validación asociada cuando el evento es `validation.`. `null` para eventos `billing.`. p. ej. `a1b2c3d4-e5f6-7890-abcd-ef0123456789`
`response_status`	`integer \| null`anulable	Código HTTP recibido del receptor. `null` cuando la entrega no llegó a establecer respuesta (timeout, SSRF block). p. ej. `100`
`response_body`	`string \| null`anulable	Cuerpo de respuesta del receptor, truncado a 500 caracteres. p. ej. `{"ok":true}`
`response_time_ms`	`integer \| null`anulable	Tiempo total del request en milisegundos. p. ej. `184`
`attempt`	`integer`	Número de intento (1 = primer envío, >1 = reintentos). p. ej. `1`
`status`	`string`	Estado actual de la entrega. `pending` — aún sin entregar; `retrying` — reintentando; `success` — entregada; `failed` — agotados los intentos. p. ej. `pending`
`next_retry_at`	`TimestampUTC \| null`	UTC ISO 8601 del próximo reintento programado. `null` cuando la entrega es terminal (delivered o agotada).
`error_message`	`string \| null`anulable	Mensaje de error si la entrega falló (`null` en éxito). p. ej. `Connection timed out after 10s`
`created_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`

**Códigos de respuesta**`GET /v1/webhooks/deliveries`
Código	Clase	Descripción	Cuerpo
200	`2xx`	Lista consolidada de entregas de todos los endpoints del usuario.	Sin cuerpo
401	`4xx`	Se requiere autenticación o las credenciales son inválidas	`ErrorResponse`
403	`4xx`	Permisos insuficientes	`ErrorResponse`
429	`4xx`	Límite de tasa excedido	`ErrorResponse`

**Errores de `GET /v1/webhooks/deliveries`**
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`
429	`rate_limit_exceeded`	Límite de peticiones excedido. Inténtalo de nuevo en 45 segundos. Envelope meta.request_id `f7a8b9c0d1e2` Cabeceras de respuesta `Retry-After`: integer — Segundos a esperar antes de reintentar. Coincide con la ventana de rate-limit del endpoint (típicamente 60s para listas, 1-5s para operaciones idempotentes en vuelo). `X-RateLimit-Limit`: integer — Límite de solicitudes configurado para este bucket (emitido sólo en 429). `X-RateLimit-Remaining`: integer — Solicitudes restantes en la ventana actual — siempre 0 en el momento del 429 (emitido sólo en 429). `X-RateLimit-Reset`: integer — Unix epoch absoluto (segundos) en que se reinicia la ventana. Emitido sólo en 429, junto con Retry-After. Puede existir sobreescritura por endpoint (p. ej. `rate_limited_login`).