---
title: "List platform webhook deliveries"
method: GET
path: "/platform/webhooks/deliveries"
tags: ["Platform Webhooks"]
---

# List platform webhook deliveries

`GET /platform/webhooks/deliveries`

Get a paginated list of platform webhook delivery attempts.

Filter by:
- `webhookId` - Specific webhook
- `tenantId` - Specific tenant
- `event` - Specific event type
- `success` - Successful (2xx) or failed deliveries
- `before`/`after` - Time range (Unix timestamps)

Deliveries are returned in reverse chronological order.

## Query parameters

- `webhookId` string
- `tenantId` string
- `event` 'MessageSent' | 'MessageDelayed' | 'MessageDeliveryFailed' | 'MessageHeld' | 'MessageBounced' | 'MessageLinkClicked' | 'MessageLoaded' | 'DomainDNSError'
- `success` boolean
- `before` integer
- `after` integer
- `page` integer
- `perPage` integer

## Response `200`

List of platform webhook deliveries

- ListPlatformWebhookDeliveriesResponse — Paginated list of platform webhook delivery attempts
  - `success` true, required
  - `data` PlatformWebhookDeliverySummary[], required
    - `id` string, required — Unique delivery ID
    - `webhookId` string, required — Platform webhook ID
    - `tenantId` string, required — Tenant that triggered the event
    - `event` 'MessageSent' | 'MessageDelayed' | 'MessageDeliveryFailed' | 'MessageHeld' | 'MessageBounced' | 'MessageLinkClicked' | 'MessageLoaded' | 'DomainDNSError', required — Event type
    - `url` string, uri, required — Endpoint URL the delivery was sent to
    - `statusCode` integer, nullable, required — HTTP status code returned by your endpoint (null if connection failed)
    - `success` boolean, required — Whether delivery was successful (2xx response)
    - `attempt` integer, required — Attempt number (1 for first attempt, higher for retries)
    - `willRetry` boolean, required — Whether this delivery will be retried
    - `timestamp` string, date-time, required — When the delivery was attempted
  - `page` integer, required — Current page number
  - `perPage` integer, required — Items per page
  - `total` integer, required — Total number of deliveries matching the filter
  - `totalPages` integer, required — Total number of pages
  - `meta` ApiMeta, required
    - `requestId` string, required — Unique request identifier for debugging and support

## Other responses

- `401` — Invalid or missing API key
- `429` — Rate limit exceeded
- `500` — Internal server error

---

[API](https://skmtc.net/arkhq-io/apis/ark-email-api.md) · [All operations](https://skmtc.net/arkhq-io/apis/ark-email-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/arkhq-io/ark-email-api/versions/98a90852ffca/schema)