# Get a webhook endpoint

> For the complete documentation index, see [llms.txt](https://www.shortsintel.com/llms.txt). Every docs page is also available as markdown: add .md to its URL. To connect, read [agents.md](https://www.shortsintel.com/agents.md).

GET `/v1/webhooks/{id}`

One endpoint.

## Price

Free.

## Parameters

| Name | In | Type | Required | Default | Description |
| --- | --- | --- | --- | --- | --- |
| `id` | path | `string` | Required | — | Webhook endpoint id. |

## Responses

### 200 OK

`{ webhook }`.

object

- `webhook` object required
  - `id` string required
  - `url` string required
  - `status` string required one of `pending`, `active`, `failed`, `disabled`
  - `description` string required nullable
  - `secret_prefix` string required The first characters of the signing secret, to tell two apart.
  - `previous_secret_expires_at` string required nullable
  - `created_at` string required
  - `activated_at` string required nullable
  - `last_delivery_at` string required nullable

### 401 Unauthorized

Codes: `missing_authorization`, `invalid_key`, `key_revoked`, `key_expired`, `invalid_token`. The problem body and every code are on [Errors](https://www.shortsintel.com/docs/reference/errors).

### 404 Not Found

Code: `not_found`. The problem body and every code are on [Errors](https://www.shortsintel.com/docs/reference/errors).

## Related guides

- [Webhooks](https://www.shortsintel.com/docs/concepts/webhooks): The events we send, how to verify a signature, what happens when your endpoint is down, and how to rotate a secret.

## Request samples

curl:

```bash
curl "https://www.shortsintel.com/v1/webhooks/whe_6d2f10ab44" \
  -H "Authorization: Bearer sk_live_YOUR_KEY"
```

TypeScript:

```typescript
const response = await fetch(
  "https://www.shortsintel.com/v1/webhooks/whe_6d2f10ab44",
  {
    method: "GET",
    headers: {
      "Authorization": "Bearer sk_live_YOUR_KEY",
    },
  },
);

if (!response.ok) {
  throw new Error(`ShortsIntel ${response.status}`);
}

const data = await response.json();
```

Python:

```python
import requests

response = requests.get(
    "https://www.shortsintel.com/v1/webhooks/whe_6d2f10ab44",
    headers={
        "Authorization": "Bearer sk_live_YOUR_KEY",
    },
)
response.raise_for_status()

data = response.json()
```

200 · `{ webhook }`.

```json
{
  "webhook": {
    "id": "whe_6d2f10ab44",
    "url": "https://hooks.example.com/shortsintel",
    "status": "active",
    "description": "production receiver",
    "secret_prefix": "whsec_a1b2c3",
    "previous_secret_expires_at": null,
    "created_at": "2026-09-08T09:14:02.418Z",
    "activated_at": "2026-09-08T09:14:03.006Z",
    "last_delivery_at": "2026-09-08T09:14:03.006Z"
  }
}
```

[Previous List webhook endpoints](https://www.shortsintel.com/docs/reference/webhooks/list-webhooks)[Next Delete a webhook endpoint](https://www.shortsintel.com/docs/reference/webhooks/delete-webhook)
