Listar entregas de un endpoint

GET https://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.
`page`	query	`integer`	opcional	Predeterminado: `1`
`per_page`	query	`integer`	opcional	Predeterminado: `50`

Petición

cURLPython•JavaScript•PHP•

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

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`
`id` *	`integer`	Identificador autoincremental de la entrega.
`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.
`endpoint_url`	`string`	URL del endpoint receptor. Solo presente en la lista cross-endpoint (`GET /webhooks/deliveries`).
`event_type`	`string`	Tipo de evento que disparó la entrega. Determina la forma del payload firmado por HMAC enviado al receptor.
`validation_id`	`string \| null` anulable	UUID de la validación asociada cuando el evento es `validation.`. `null` para eventos `billing.`.
`response_status`	`integer \| null` anulable	Código HTTP recibido del receptor. `null` cuando la entrega no llegó a establecer respuesta (timeout, SSRF block).
`response_body`	`string \| null` anulable	Cuerpo de respuesta del receptor, truncado a 500 caracteres.
`response_time_ms`	`integer \| null` anulable	Tiempo total del request en milisegundos.
`attempt`	`integer`	Número de intento (1 = primer envío, >1 = reintentos).
`status`	`string`	Estado actual de la entrega.
`next_retry_at`	`union`	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).
`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.

**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	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`
429	`rate_limit_exceeded`	Rate limit exceeded. Try again in 45 seconds. 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`).