Listar entregas de un endpoint

GEThttps://api.veriko.mx/v1/webhooks/{id}/deliveries

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

Devuelve los 50 intentos de entrega más recientes de un endpoint específico, con código de respuesta HTTP, tiempo de respuesta y cuerpo de la respuesta truncado. Útil para diagnosticar fallos de entrega.

Parámetros
Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`id`*	path	`string (uuid)`	obligatorio	UUID del endpoint de webhook. p. ej. `f47ac10b-58cc-4372-a567-0e02b2c3d479`
`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`

Petición

cURLPython•JavaScript•PHP•

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

Ejemplo en Python — próximamente.

Ejemplo en JavaScript — próximamente.

Ejemplo en PHP — próximamente.

**Respuesta 200**`WebhookDelivery` — Intentos de entrega paginados para este endpoint con código HTTP, tiempo de respuesta y cuerpo truncado.
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/{id}/deliveries`
Código	Clase	Descripción	Cuerpo
200	`2xx`	Intentos de entrega paginados para este endpoint con código HTTP, tiempo de respuesta y cuerpo truncado.	Sin cuerpo
401	`4xx`	Se requiere autenticación o las credenciales son inválidas	`ErrorResponse`
403	`4xx`	Permisos insuficientes	`ErrorResponse`
404	`4xx`	`not_found` — el endpoint no existe o no pertenece al usuario.	`ErrorResponse`
429	`4xx`	Límite de tasa excedido	`ErrorResponse`

**Errores de `GET /v1/webhooks/{id}/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`).