---
title: "Recent deliveries"
method: GET
path: "/v1/webhooks/{id}/deliveries"
tags: ["Webhooks"]
---

# Recent deliveries

`GET /v1/webhooks/{id}/deliveries`

## Request

- Base URL: `https://api.sonovault.now`
- URL: `https://api.sonovault.now/v1/webhooks/{id}/deliveries`
- Auth: API key in header `x-api-key`

The endpoint's recent delivery attempts (status, HTTP response, attempt count), for debugging integrations.

## Path parameters

- `id` string, required

## Response `200`

Successful response

- object
  - `deliveries` WebhookDelivery[], required: Recent delivery attempts, newest first.
    - `id` string, required: Delivery ID.
    - `event_id` string, required: The event delivered. Stable across retries, so it is the right key to dedupe on.
    - `event_type` 'stream.play.started' | 'stream.offline' | 'stream.online', required: The event's type.
    - `status` 'pending' | 'success' | 'failed' | 'dead', required: Outcome so far: `pending` while a retry is still scheduled, `failed` for an attempt that will be retried, `dead` once we gave up after 12 attempts.
    - `attempts` integer, required: How many times we have tried, including the first.
    - `response_status` integer, nullable, required: HTTP status your endpoint returned. `null` when the request never completed (timeout, DNS, TLS).
    - `error` string, nullable, required: Why it failed. `null` on success.
    - `created_at` string, required: When the event was queued, ISO-8601 UTC.
    - `last_attempt_at` string, nullable, required: Most recent attempt, ISO-8601 UTC. `null` before the first.
    - `next_attempt_at` string, nullable, required: Next scheduled retry, ISO-8601 UTC. `null` once delivered or given up on.

---

[API](https://skmtc.dev/sonovault/apis/sonovault-api.md) · [All operations](https://skmtc.dev/sonovault/apis/sonovault-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sonovault/apis/sonovault-api/revisions/0152fff23f2c?raw)
