> ## Documentation Index
> Fetch the complete documentation index at: https://docs.daya.co/llms.txt
> Use this file to discover all available pages before exploring further.

# List Webhooks

> List all webhooks for the authenticated user

## Overview

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

<Info>
  Pro webhook setup is support-managed. Contact [support@daya.co](mailto:support@daya.co) to configure webhook endpoints for your Pro account.
</Info>

## Authentication

<ParamField header="X-Api-Key" type="string" required>
  Your API key with Write scope

  ```
  X-Api-Key: daya_sk_YOUR_API_KEY
  ```
</ParamField>

## Request Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://api.pro.daya.co/public/v1/webhooks' \
    --header 'X-Api-Key: daya_sk_YOUR_API_KEY'
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    'https://api.pro.daya.co/public/v1/webhooks',
    {
      headers: { 'X-Api-Key': 'daya_sk_YOUR_API_KEY' }
    }
  );

  const data = await response.json();
  console.log('Webhooks:', data.data);
  ```

  ```python Python theme={null}
  import requests

  headers = {'X-Api-Key': 'daya_sk_YOUR_API_KEY'}

  response = requests.get(
      'https://api.pro.daya.co/public/v1/webhooks',
      headers=headers
  )

  webhooks = response.json()
  print(f"Webhooks: {webhooks['data']}")
  ```

  ```go Go theme={null}
  package main

  import (
      "encoding/json"
      "fmt"
      "net/http"
  )

  func main() {
      req, _ := http.NewRequest("GET", "https://api.pro.daya.co/public/v1/webhooks", nil)
      req.Header.Set("X-Api-Key", "daya_sk_YOUR_API_KEY")

      client := &http.Client{}
      resp, err := client.Do(req)
      if err != nil {
          panic(err)
      }
      defer resp.Body.Close()

      var result map[string]interface{}
      json.NewDecoder(resp.Body).Decode(&result)
      fmt.Println("Webhooks:", result["data"])
  }
  ```
</CodeGroup>

## Response

<ResponseField name="success" type="boolean" required>
  Indicates if the request was successful
</ResponseField>

<ResponseField name="message" type="string" required>
  Human-readable response message
</ResponseField>

<ResponseField name="data" type="array" required>
  Array of webhook objects

  <Expandable title="webhook properties">
    <ResponseField name="id" type="string">
      Unique webhook identifier (UUID)
    </ResponseField>

    <ResponseField name="url" type="string">
      Webhook endpoint URL
    </ResponseField>

    <ResponseField name="description" type="string">
      Webhook description
    </ResponseField>

    <ResponseField name="events" type="array">
      Events this webhook is subscribed to

      **Values:** `order.created`, `order.filled`, `order.partially_filled`, `order.cancelled`, `order.rejected`, `trade.executed`, `deposit.completed`, `crypto.deposit.completed`
    </ResponseField>

    <ResponseField name="status" type="string">
      Webhook status

      **Values:** `active`, `paused`, `disabled`
    </ResponseField>

    <ResponseField name="failure_count" type="integer">
      Number of consecutive delivery failures
    </ResponseField>

    <ResponseField name="last_success_at" type="string">
      Last successful delivery timestamp (ISO 8601)
    </ResponseField>

    <ResponseField name="last_failure_at" type="string">
      Last failed delivery timestamp (ISO 8601)
    </ResponseField>

    <ResponseField name="last_failure_reason" type="string">
      Reason for last delivery failure
    </ResponseField>

    <ResponseField name="created_at" type="string">
      ISO 8601 creation timestamp
    </ResponseField>

    <ResponseField name="updated_at" type="string">
      ISO 8601 last update timestamp
    </ResponseField>
  </Expandable>
</ResponseField>

### Success Response

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "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"
  }
  ```
</ResponseExample>

## Error Responses

<ResponseExample>
  ```json 401 Unauthorized theme={null}
  {
    "success": false,
    "message": "Unauthorized",
    "error": {
      "code": "API_KEY_INVALID",
      "message": "The provided API key is invalid"
    }
  }
  ```

  ```json 403 Forbidden theme={null}
  {
    "success": false,
    "message": "Forbidden",
    "error": {
      "code": "API_KEY_INVALID_SCOPE",
      "message": "Insufficient scope for this operation"
    }
  }
  ```
</ResponseExample>

## Webhook Status

| Status     | Description                                        |
| ---------- | -------------------------------------------------- |
| `active`   | Webhook is enabled and receiving events            |
| `paused`   | Webhook is temporarily disabled by user            |
| `disabled` | Webhook was auto-disabled due to repeated failures |

## Rate Limits

* **100 requests per minute** per API key

## Next Steps

<CardGroup cols={2}>
  <Card title="Create Webhook" icon="plus" href="/pro/api-reference/create-webhook">
    Create a new webhook endpoint
  </Card>

  <Card title="Webhook Overview" icon="bell" href="/pro/webhooks/overview">
    Learn about webhook events and payloads
  </Card>
</CardGroup>