---
title: "List delivery history"
method: GET
path: "/v1/communities/{communityId}/webhooks/{webhookId}/deliveries"
tags: ["Webhooks"]
---

# List delivery history

`GET /v1/communities/{communityId}/webhooks/{webhookId}/deliveries`

## Request

- Base URL: `https://api.subo.ai`
- URL: `https://api.subo.ai/v1/communities/{communityId}/webhooks/{webhookId}/deliveries`
- Auth: API key in header `X-API-Key`

List delivery attempts for a webhook, ordered newest first. Use this to debug failed deliveries — each record shows the HTTP status returned by your endpoint, the response body, attempt count, and next retry time.

Delivery lifecycle: `pending` → `delivered` on 2xx, or `pending` (retried) → `failed` → eventually `abandoned` after 5 attempts.

## Path parameters

- `communityId` string, required
- `webhookId` string, required

## Query parameters

- `status` 'pending' | 'delivered' | 'failed' | 'abandoned'
- `page` integer
- `per_page` integer

## Response `200`

Paginated list of delivery attempts

- object
  - `data` WebhookDelivery[]
    - `id` string
    - `webhook_id` string
    - `event_type` string
    - `event_id` string, uuid, nullable
    - `status` 'pending' | 'delivered' | 'failed' | 'abandoned'
    - `attempt_count` integer
    - `response_status` integer, nullable: HTTP status code returned by the endpoint
    - `response_body` string, nullable: First 1000 characters of the endpoint's response body
    - `last_attempt_at` string, date-time, nullable
    - `next_retry_at` string, date-time, nullable
    - `created_at` string, date-time, nullable
  - `pagination` Pagination
    - `page` integer
    - `per_page` integer
    - `total` integer
    - `has_more` boolean

## Other responses

- `401`: Invalid or missing API key
- `403`: Forbidden — the key or user lacks permission for this resource or operation
- `404`: Resource not found
- `429`: Rate limit exceeded — wait `retry_after` seconds before retrying. The same value appears in the `Retry-After` header.

---

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