---
title: "List webhook deliveries"
method: GET
path: "/v1/webhook_deliveries"
tags: ["Webhook Deliveries"]
---

# List webhook deliveries

`GET /v1/webhook_deliveries`

## Request

- Base URL: `https://api.augustus.com`
- URL: `https://api.augustus.com/v1/webhook_deliveries`
- Auth: HTTP bearer

Lists webhook deliveries for the merchant with cursor-based pagination. Deliveries are retained for 30 days.

## Query parameters

- `limit` integer
- `cursor` string
- `event_id` string, uuid
- `subscription_id` string, uuid
- `status` 'pending' | 'delivered' | 'failed' | 'processing' | 'ignored'
- `created_at.gte` string, date-time
- `created_at.lte` string, date-time

## Response `200`

Paginated list of webhook deliveries

- ListWebhookDeliveriesResponseDto
  - `data` object[], required
    - `id` string, uuid, required: Unique identifier of the webhook delivery.
    - `type` 'webhook_delivery', required: Resource type discriminator.
    - `event_id` string, uuid, required: Identifier of the event this delivery was for.
    - `subscription_id` string, uuid, required: Identifier of the webhook subscription this delivery targeted.
    - `status` 'pending' | 'delivered' | 'failed' | 'processing' | 'ignored', required: Current status of the delivery.
    - `attempts` object[], required: Ordered list of HTTP delivery attempts for this delivery.
      - `attempted_at` string, date-time, required: ISO 8601 UTC timestamp when this attempt resolved.
      - `status` 'pending' | 'delivered' | 'failed' | 'processing' | 'ignored', required: Current status of the delivery.
      - `status_code` integer, required: HTTP status code returned by the receiver for this attempt.
    - `created_at` string, date-time, required: ISO 8601 UTC timestamp when the delivery was created.
    - `updated_at` string, date-time, required: ISO 8601 UTC timestamp when the delivery was last updated.
  - `has_more` boolean, required
  - `next_cursor` string, nullable, required
  - `has_previous` boolean, required
  - `previous_cursor` string, nullable, required

## Changes

- **2026-10-16** `f7ded6c181ab`: 1 info
  - endpoint added
- **2026-04-22** `7e26180bf667`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/augustus/apis/ivy-api/changes/v1/webhook_deliveries/get.md)

---

[API](https://skmtc.dev/augustus/apis/ivy-api.md) - [All operations](https://skmtc.dev/augustus/apis/ivy-api/llms.txt) - [OpenAPI document](https://skmtc.dev/augustus/apis/ivy-api/revisions/e87bdcac11cc?raw)