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

# List Webhook Endpoints

> List webhook endpoints (secrets redacted)

## Overview

Requires the `portfolios:manage` scope.

## Query Parameters

<ParamField query="limit" type="integer" default="20">Page size (1-100).</ParamField>
<ParamField query="cursor" type="string">Opaque cursor.</ParamField>

## Response

`object: "list"` envelope of `Webhook` objects (see
[Create Webhook Endpoint](/api-reference/monitoring/webhooks/create) for the shape), with
`secret` redacted.

## Errors

| Status | `type`             | When                        |
| ------ | ------------------ | --------------------------- |
| 400    | `validation_error` | Invalid `limit` or `cursor` |

## Code Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.signa.so/v1/webhooks" \
    -H "Authorization: Bearer sig_YOUR_KEY"
  ```

  ```typescript TypeScript theme={null}
  import { Signa } from "@signa-so/sdk";
  const signa = new Signa({ api_key: process.env.SIGNA_API_KEY });

  const endpoints = await signa.webhooks.list();
  ```
</CodeGroup>

<ResponseExample>
  ```json theme={null}
  {
    "object": "list",
    "data": [
      {
        "id": "whk_2mR8vNkT",
        "object": "webhook_endpoint",
        "url": "https://hooks.auroradigital.example.com/signa",
        "description": "Production alerts for Aurora Digital",
        "enabled_events": ["alert.created"],
        "status": "active",
        "secret_version": 1,
        "consecutive_failures": 0,
        "last_success_at": "2026-07-05T09:12:31.000Z",
        "last_failure_at": null,
        "metadata": {},
        "created_at": "2026-07-06T08:00:00.000Z",
        "updated_at": "2026-07-06T08:00:00.000Z"
      }
    ],
    "has_more": false,
    "pagination": { "cursor": null },
    "request_id": "req_5tQmR2vX"
  }
  ```
</ResponseExample>

## Related Endpoints

* [Create Webhook Endpoint](/api-reference/monitoring/webhooks/create) - register a new endpoint
* [Retrieve Webhook Endpoint](/api-reference/monitoring/webhooks/retrieve) - get a single endpoint