# GET /v2/webhooks/{id}

**Get one webhook**

Returns the current state of a webhook subscription. Visibility is key-scoped: webhooks created by another key (even on the same account) return 404.

## Plan access

- **Plan access.** Included on every plan.
- **Cadence.** Hobby 5m · Pro 1m · Scale 1m · Enterprise 1m.
- **Capacity.** Hobby 5 · Pro 25 · Scale 100 · Enterprise unlimited.

## Query / path parameters

| Name | In | Type | Required | Description |
|------|----|----|----------|-------------|
| `id` | path | string | yes | Webhook id returned by `POST /v2/webhooks`. Example: `wh_smRsF3-z36o`. |

## Status codes

- **200** — The webhook doc (no `signing_secret`).
- **404** — Webhook not found (or not owned by this key).

## Sample response

```json
{
  "as_of": "2026-05-14T11:41:01.000Z",
  "id": "wh_smRsF3-z36o",
  "name": "breakouts-on-tech",
  "q": "breakout AND sector = 'Technology'",
  "target_url": "https://your-app.example.com/webhooks/tickerbot",
  "status": "active",
  "cadence": "1m",
  "source": "v2",
  "created_at": 1778720416,
  "updated_at": 1778720500,
  "last_match_set": ["AAPL", "NVDA"],
  "last_evaluated_at": 1778721240
}
```

## Examples

### Get one

Request:

```shell
curl https://api.tickerbot.io/v2/webhooks/wh_smRsF3-z36o \
  -H "Authorization: Bearer YOUR_KEY"
```

Response (`200`):

```json
{
  "as_of": "2026-05-14T11:41:01.000Z",
  "id": "wh_smRsF3-z36o",
  "name": "breakouts-on-tech",
  "q": "breakout AND sector = 'Technology'",
  "target_url": "https://your-app.example.com/webhooks/tickerbot",
  "status": "active",
  "cadence": "1m",
  "source": "v2",
  "created_at": 1778720416,
  "updated_at": 1778720500,
  "last_match_set": ["AAPL", "NVDA"],
  "last_evaluated_at": 1778721240
}
```

---

Interactive sandbox + parameter editor: https://tickerbot.io/api/endpoints/webhooks/get