Skip to main content
GET
/
public
/
v1
/
webhooks
List Webhooks
curl --request GET \
  --url https://api.pro.daya.co/public/v1/webhooks \
  --header 'X-Api-Key: <x-api-key>'
{
  "success": true,
  "message": "Webhooks retrieved successfully",
  "data": [
    {
      "id": "770e8400-e29b-41d4-a716-446655440000",
      "url": "https://example.com/webhooks/daya",
      "description": "Order notifications",
      "events": ["order.filled", "order.cancelled"],
      "status": "active",
      "failure_count": 0,
      "last_success_at": "2024-01-15T10:30:00Z",
      "last_failure_at": null,
      "last_failure_reason": null,
      "created_at": "2024-01-01T00:00:00Z",
      "updated_at": "2024-01-15T10:30:00Z"
    },
    {
      "id": "770e8400-e29b-41d4-a716-446655440001",
      "url": "https://example.com/webhooks/daya-trades",
      "description": "Trade notifications",
      "events": ["trade.executed"],
      "status": "paused",
      "failure_count": 3,
      "last_success_at": "2024-01-10T15:00:00Z",
      "last_failure_at": "2024-01-15T08:00:00Z",
      "last_failure_reason": "Connection timeout",
      "created_at": "2024-01-05T00:00:00Z",
      "updated_at": "2024-01-15T08:00:00Z"
    }
  ],
  "timestamp": "2024-01-15T10:30:00Z"
}

​
Overview

Retrieve all webhook endpoints configured for the authenticated user. Use this to view your webhook configurations and their status.

​
Authentication

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

​
Request Examples

curl --request GET \
  --url 'https://api.pro.daya.co/public/v1/webhooks' \
  --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 webhook objects

​
Success Response

{
  "success": true,
  "message": "Webhooks retrieved successfully",
  "data": [
    {
      "id": "770e8400-e29b-41d4-a716-446655440000",
      "url": "https://example.com/webhooks/daya",
      "description": "Order notifications",
      "events": ["order.filled", "order.cancelled"],
      "status": "active",
      "failure_count": 0,
      "last_success_at": "2024-01-15T10:30:00Z",
      "last_failure_at": null,
      "last_failure_reason": null,
      "created_at": "2024-01-01T00:00:00Z",
      "updated_at": "2024-01-15T10:30:00Z"
    },
    {
      "id": "770e8400-e29b-41d4-a716-446655440001",
      "url": "https://example.com/webhooks/daya-trades",
      "description": "Trade notifications",
      "events": ["trade.executed"],
      "status": "paused",
      "failure_count": 3,
      "last_success_at": "2024-01-10T15:00:00Z",
      "last_failure_at": "2024-01-15T08:00:00Z",
      "last_failure_reason": "Connection timeout",
      "created_at": "2024-01-05T00:00:00Z",
      "updated_at": "2024-01-15T08:00:00Z"
    }
  ],
  "timestamp": "2024-01-15T10:30:00Z"
}

​
Error Responses

{
  "success": false,
  "message": "Unauthorized",
  "error": {
    "code": "API_KEY_INVALID",
    "message": "The provided API key is invalid"
  }
}

​
Webhook Status

StatusDescription
activeWebhook is enabled and receiving events
pausedWebhook is temporarily disabled by user
disabledWebhook was auto-disabled due to repeated failures

​
Rate Limits

  • 100 requests per minute per API key

​
Next Steps

Create Webhook

Create a new webhook endpoint

Webhook Overview

Learn about webhook events and payloads