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"
}

GET

public

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

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

Show delivery log properties

string

Unique delivery log identifier (UUID)

event_id

string

Event identifier (UUID)

event_type

string

Type of eventValues: order.created, order.filled, order.partially_filled, order.cancelled, order.rejected, trade.executed, deposit.completed

status

string

Delivery statusValues: pending, delivered, failed, retrying

attempts

integer

Number of delivery attempts made

max_attempts

integer

Maximum delivery attempts allowed

response_status_code

integer

HTTP response status code from your endpoint (if any)

last_error

string

Last error message (if any)

last_attempt_at

string

Timestamp of last delivery attempt (ISO 8601)

next_retry_at

string

Timestamp of next retry attempt (ISO 8601, if retrying)

delivered_at

string

Timestamp when successfully delivered (ISO 8601)

created_at

string

ISO 8601 creation timestamp

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

Status	Description
`pending`	Event queued, not yet attempted
`delivered`	Successfully delivered (2xx response)
`retrying`	Delivery failed, will retry
`failed`	All retry attempts exhausted

Retry Behavior

Failed deliveries are retried with exponential backoff:

Attempt	Delay After Previous
1	10 seconds
2	30 seconds
3	1 minute
4	5 minutes
5	15 minutes
6	30 minutes
7	1 hour
8	2 hours
9	4 hours
10	8 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

Rotate Webhook Secret Webhooks Overview

​Overview

​Authentication

​Path Parameters

​Query Parameters

​Request Examples

​Response

​Success Response

​Error Responses

​Delivery Status

​Retry Behavior

​Rate Limits

​Next Steps

Get Webhook

Update Webhook

Webhook Overview

Webhook Verification

Overview

Authentication

Path Parameters

Query Parameters

Request Examples

Response

Success Response

Error Responses

Delivery Status

Retry Behavior

Rate Limits

Next Steps