Skip to main content
GET
/
public
/
v1
/
webhooks
/
{id}
/
deliveries
Get Webhook Deliveries
curl --request GET \
  --url https://api.pro.daya.co/public/v1/webhooks/{id}/deliveries \
  --header 'X-Api-Key: <x-api-key>'
{
  "success": true,
  "message": "Delivery logs retrieved successfully",
  "data": [
    {
      "id": "880e8400-e29b-41d4-a716-446655440000",
      "event_id": "550e8400-e29b-41d4-a716-446655440000",
      "event_type": "order.filled",
      "status": "delivered",
      "attempts": 1,
      "max_attempts": 10,
      "response_status_code": 200,
      "last_error": null,
      "last_attempt_at": "2024-01-15T10:30:01Z",
      "next_retry_at": null,
      "delivered_at": "2024-01-15T10:30:01Z",
      "created_at": "2024-01-15T10:30:00Z"
    },
    {
      "id": "880e8400-e29b-41d4-a716-446655440001",
      "event_id": "550e8400-e29b-41d4-a716-446655440001",
      "event_type": "order.cancelled",
      "status": "retrying",
      "attempts": 3,
      "max_attempts": 10,
      "response_status_code": 500,
      "last_error": "Internal Server Error",
      "last_attempt_at": "2024-01-15T10:35:00Z",
      "next_retry_at": "2024-01-15T10:40:00Z",
      "delivered_at": null,
      "created_at": "2024-01-15T10:00:00Z"
    },
    {
      "id": "880e8400-e29b-41d4-a716-446655440002",
      "event_id": "550e8400-e29b-41d4-a716-446655440002",
      "event_type": "trade.executed",
      "status": "failed",
      "attempts": 10,
      "max_attempts": 10,
      "response_status_code": 0,
      "last_error": "Connection timeout",
      "last_attempt_at": "2024-01-14T22:00:00Z",
      "next_retry_at": null,
      "delivered_at": null,
      "created_at": "2024-01-14T08:00:00Z"
    }
  ],
  "timestamp": "2024-01-15T10:35:00Z"
}

​
Overview

Retrieve the delivery history for a specific webhook. Use this to monitor webhook delivery status, debug failures, and track retry attempts.

​
Authentication

​
X-Api-Key
string
required
Your API key with Write scope
X-Api-Key: daya_sk_YOUR_API_KEY

​
Path Parameters

​
id
string
required
Webhook ID (UUID)Example: 770e8400-e29b-41d4-a716-446655440000

​
Query Parameters

​
limit
integer
Number of logs to returnDefault: 50Range: 1 to 100
​
offset
integer
Offset for paginationDefault: 0

​
Request Examples

curl --request GET \
  --url 'https://api.pro.daya.co/public/v1/webhooks/770e8400-e29b-41d4-a716-446655440000/deliveries?limit=20' \
  --header 'X-Api-Key: daya_sk_YOUR_API_KEY'

​
Response

​
success
boolean
required
Indicates if the request was successful
​
message
string
required
Human-readable response message
​
data
array
required
Array of delivery log objects

​
Success Response

{
  "success": true,
  "message": "Delivery logs retrieved successfully",
  "data": [
    {
      "id": "880e8400-e29b-41d4-a716-446655440000",
      "event_id": "550e8400-e29b-41d4-a716-446655440000",
      "event_type": "order.filled",
      "status": "delivered",
      "attempts": 1,
      "max_attempts": 10,
      "response_status_code": 200,
      "last_error": null,
      "last_attempt_at": "2024-01-15T10:30:01Z",
      "next_retry_at": null,
      "delivered_at": "2024-01-15T10:30:01Z",
      "created_at": "2024-01-15T10:30:00Z"
    },
    {
      "id": "880e8400-e29b-41d4-a716-446655440001",
      "event_id": "550e8400-e29b-41d4-a716-446655440001",
      "event_type": "order.cancelled",
      "status": "retrying",
      "attempts": 3,
      "max_attempts": 10,
      "response_status_code": 500,
      "last_error": "Internal Server Error",
      "last_attempt_at": "2024-01-15T10:35:00Z",
      "next_retry_at": "2024-01-15T10:40:00Z",
      "delivered_at": null,
      "created_at": "2024-01-15T10:00:00Z"
    },
    {
      "id": "880e8400-e29b-41d4-a716-446655440002",
      "event_id": "550e8400-e29b-41d4-a716-446655440002",
      "event_type": "trade.executed",
      "status": "failed",
      "attempts": 10,
      "max_attempts": 10,
      "response_status_code": 0,
      "last_error": "Connection timeout",
      "last_attempt_at": "2024-01-14T22:00:00Z",
      "next_retry_at": null,
      "delivered_at": null,
      "created_at": "2024-01-14T08:00:00Z"
    }
  ],
  "timestamp": "2024-01-15T10:35:00Z"
}

​
Error Responses

{
  "success": false,
  "message": "Validation error",
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid webhook ID format"
  }
}

​
Delivery Status

StatusDescription
pendingEvent queued, not yet attempted
deliveredSuccessfully delivered (2xx response)
retryingDelivery failed, will retry
failedAll retry attempts exhausted

​
Retry Behavior

Failed deliveries are retried with exponential backoff:
AttemptDelay After Previous
110 seconds
230 seconds
31 minute
45 minutes
515 minutes
630 minutes
71 hour
82 hours
94 hours
108 hours
After 10 failed attempts, the delivery is marked as failed and the webhook may be automatically disabled.

​
Rate Limits

  • 100 requests per minute per API key

​
Next Steps

Get Webhook

View webhook details

Update Webhook

Update webhook configuration

Webhook Overview

Learn about webhook events

Webhook Verification

Verify webhook signatures