---
title: "List Delivery Attempts"
method: GET
path: "/v1/webhooks/subscriptions/{subscription_id}/deliveries"
tags: ["Webhooks"]
---

# List Delivery Attempts

`GET /v1/webhooks/subscriptions/{subscription_id}/deliveries`

## Request

- Base URL: `https://api.monaco.com`
- URL: `https://api.monaco.com/v1/webhooks/subscriptions/{subscription_id}/deliveries`
- Auth: none declared

Returns one row per HTTP attempt made against this subscription's endpoint, newest first, so a failing integration can be diagnosed without asking support. Retries appear as separate rows sharing a `source_event_id`, numbered by `attempt`.

`error` carries the returned status or the transport error's class and message. The response body your endpoint returned is never stored or returned, and neither is the signing secret or the delivered payload.

Scoped to the calling org: a subscription belonging to another org is a 404, and a deleted subscription keeps its history.

**Error codes**

| `error.code` | HTTP | Cause | What to do |
| --- | --- | --- | --- |
| `not_found` | 422 | No subscription with this id exists in the calling org. | Check the id; a deleted subscription is never returned. |

## Path parameters

- `subscription_id` string, uuid, required

## Query parameters

- `page` integer: Page number (1-indexed)
- `page_size` integer: Attempts per page
- `status` 'succeeded' | 'failed'
- `source_event_id` string, nullable: Return only attempts that delivered this envelope id

## Response `200`

Successful Response

- PublicListResponseWebhookDeliveryAttemptResponse
  - `data` WebhookDeliveryAttemptResponse[], required
    - `id` string, uuid, required: Identifier of this attempt
    - `subscription_id` string, uuid, required
    - `source_event_id` string, required: The envelope `id` this attempt delivered; equal across its retries
    - `trigger_key` string, required
    - `attempt` integer, required: 1 for the first attempt, then 2, 3 and 4 for the retries
    - `status` string, required: `succeeded` or `failed`
    - `response_code` integer, nullable: HTTP status the endpoint returned, or null if no response was received
    - `duration_ms` integer, required: Wall time of the attempt in milliseconds
    - `error` string, nullable: Why the attempt failed: the returned status, or the transport error's class and message. Never contains the response body.
    - `created_at` string, date-time, required
  - `pagination` PaginationInfo, required
    - `page` integer, required: Current page number
    - `page_size` integer, required: Number of results per page
    - `total_count` integer, required: Total number of matching records
    - `total_pages` integer, required: Total number of pages
  - `meta` ResponseMeta
    - `timestamp` string, date-time: Server timestamp of the response

## Other responses

- `4XX`: Client error

## Changes

- **2026-11-03** `fc720ada2a81`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/monaco/apis/monaco-public-api/changes/v1/webhooks/subscriptions/:subscription_id/deliveries/get.md)

---

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