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

# List Webhooks

> List all registered webhook endpoints

Returns all webhook endpoints for your API key, newest first.

### Response (200 OK)

<ResponseField name="webhooks" type="object[]">
  Array of registered webhook endpoints.

  <Expandable title="properties">
    <ResponseField name="id" type="string">Endpoint UUID.</ResponseField>
    <ResponseField name="url" type="string">Destination URL.</ResponseField>
    <ResponseField name="events" type="string[]">Subscribed event types.</ResponseField>
    <ResponseField name="description" type="string | null">Your label for the endpoint.</ResponseField>

    <ResponseField name="secret_prefix" type="string">
      First 8 characters of the signing secret — enough to identify which secret an
      endpoint uses, useless as a key. The full secret is returned only by
      [Register Webhook](/api-reference/register-webhook) and
      [Rotate Secret](/api-reference/rotate-webhook-secret).

      Before 2026-08-15 this field was the full secret. If you stored a response
      from that period, see [FD-2026-001](/security).
    </ResponseField>

    <ResponseField name="payload_version" type="string">
      `v1` for the documented envelope, `legacy` for the flat payload sent to
      endpoints registered before 2026-08-15. See [Webhooks](/guides/webhooks).
    </ResponseField>

    <ResponseField name="is_active" type="boolean">Whether deliveries are attempted.</ResponseField>
    <ResponseField name="created_at" type="string">ISO 8601 timestamp.</ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl https://api.fastdrop.io/api/v1/webhooks \
    -H "X-API-Key: fd_live_your_key_here"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "webhooks": [
      {
        "id": "3f9a1c22-8e4b-4d7a-9c11-77d2f0b5a8e3",
        "url": "https://your-server.com/webhooks/fastdrop",
        "events": ["job.completed", "job.failed"],
        "description": "Production webhook",
        "secret_prefix": "a1b2c3d4",
        "payload_version": "v1",
        "is_active": true,
        "created_at": "2026-08-15T12:00:00Z"
      }
    ]
  }
  ```
</ResponseExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.