> ## 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.

# Retrieve Webhook Endpoint

> Get a single endpoint (secret redacted)

## Overview

Requires the `portfolios:manage` scope.

## Path Parameters

<ParamField path="id" type="string" required>Endpoint ID (`whk_*`).</ParamField>

## Response

A single `Webhook` (see [Create Webhook Endpoint](/api-reference/monitoring/webhooks/create) for
the shape), secret redacted. To get a fresh signing secret, use
[Rotate Secret](/api-reference/monitoring/webhooks/rotate-secret).

## Errors

| Status | `type`      | When                                             |
| ------ | ----------- | ------------------------------------------------ |
| 404    | `not_found` | Endpoint doesn't exist or belongs to another org |

## Code Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.signa.so/v1/webhooks/whk_2mR8vNkT" \
    -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 wh = await signa.webhooks.retrieve("whk_2mR8vNkT");
  ```
</CodeGroup>

<ResponseExample>
  ```json theme={null}
  {
    "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",
    "request_id": "req_6tYpL2Qn"
  }
  ```
</ResponseExample>

## Related Endpoints

* [Update Webhook Endpoint](/api-reference/monitoring/webhooks/update) - change URL, events, or status
* [Rotate Webhook Secret](/api-reference/monitoring/webhooks/rotate-secret) - get a fresh signing secret
* [List Webhook Deliveries](/api-reference/monitoring/webhooks/list-deliveries) - delivery history for this endpoint