Skip to main content
GET
/
tenants
/
{tenantId}
/
webhooks
/
{webhookId}
/
deliveries
List webhook deliveries
curl --request GET \
  --url https://api.arkhq.io/v1/tenants/{tenantId}/webhooks/{webhookId}/deliveries \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "whr_abc123def456",
      "webhookId": "456",
      "event": "MessageSent",
      "url": "https://myapp.com/webhooks/email",
      "statusCode": 200,
      "success": true,
      "attempt": 1,
      "willRetry": false,
      "timestamp": "2024-01-15T10:30:00Z"
    },
    {
      "id": "whr_xyz789ghi012",
      "webhookId": "456",
      "event": "MessageBounced",
      "url": "https://myapp.com/webhooks/email",
      "statusCode": 500,
      "success": false,
      "attempt": 3,
      "willRetry": true,
      "timestamp": "2024-01-15T09:15:00Z"
    }
  ],
  "page": 1,
  "perPage": 30,
  "total": 150,
  "totalPages": 5,
  "meta": {
    "requestId": "req_V1StGXR8_Z5jdHi6"
  }
}

Authorizations

Authorization
string
header
required

Use your API key from arkhq.io/org/credentials

Authorization: Bearer YOUR_API_KEY

Path Parameters

tenantId
string
required

The tenant ID

webhookId
string
required

Webhook ID

Query Parameters

page
integer
default:1

Page number (default 1)

Required range: x >= 1
perPage
integer
default:30

Items per page (default 30, max 100)

Required range: 1 <= x <= 100
success
boolean

Filter by delivery success (true = 2xx response, false = non-2xx or error)

event
enum<string>

Filter by event type

Available options:
MessageSent,
MessageDelayed,
MessageDeliveryFailed,
MessageHeld,
MessageBounced,
MessageLinkClicked,
MessageLoaded,
DomainDNSError
before
integer

Only deliveries before this Unix timestamp

after
integer

Only deliveries after this Unix timestamp

Response

List of webhook deliveries

Paginated list of webhook delivery attempts

data
object[]
required
page
integer
required

Current page number

Example:

1

perPage
integer
required

Items per page

Example:

30

total
integer
required

Total number of deliveries matching the filter

Example:

150

totalPages
integer
required

Total number of pages

Example:

5

meta
object
required