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

# Retrieve the Current Webhook Configuration for Your Tenant

> GET /api/v1/tenant/webhook — retrieves the current webhook URL for your tenant. The webhook secret is always masked in this response for security.

Use this endpoint to retrieve the webhook configuration currently registered for your tenant. The response includes the configured URL and a masked representation of the signing secret. Because the secret is never returned in plaintext after initial registration, use this endpoint to confirm that a webhook URL is set and to inspect its URL — not to recover the secret. If you need to rotate the secret, update the webhook using the PUT endpoint.

## Endpoint

```
GET /api/v1/tenant/webhook
```

## Authorization

Requires an API key with `WEBHOOK_MANAGE` scope.

<Note>
  The webhook signing secret is **always masked** in this response — you get the first 8 hex characters followed by `...` (for example, `a1b2c3d4...`). If you have lost the secret, use [Update Webhook](/api-reference/admin/update-webhook) to register a new URL — a fresh secret will be issued and shown once in that response.
</Note>

## Request Example

```bash theme={null}
curl --request GET \
  --url https://api.your-domain.com/api/v1/tenant/webhook \
  --header 'Authorization: Bearer <api-key>'
```

## Response

<ResponseField name="webhookUrl" type="string" required>
  The HTTPS URL that Idem will POST event payloads to.
</ResponseField>

<ResponseField name="secretPrefix" type="string" required>
  The first 8 hex characters of the signing secret, followed by `...`. The raw value is never returned by this endpoint.
</ResponseField>

## Response Example

```json theme={null}
{
  "webhookUrl": "https://example.com/webhooks/idem",
  "secretPrefix": "a1b2c3d4..."
}
```

## Error Codes

| Code  | Meaning                                                                                                                        |
| ----- | ------------------------------------------------------------------------------------------------------------------------------ |
| `401` | Missing or invalid API key.                                                                                                    |
| `403` | The provided API key does not have `WEBHOOK_MANAGE` scope.                                                                     |
| `404` | No webhook has been configured for your tenant yet. Use [Update Webhook](/api-reference/admin/update-webhook) to register one. |