---
title: "List your webhook subscriptions (Pro+)"
method: GET
path: "/v1/webhooks"
tags: ["webhooks"]
---

# List your webhook subscriptions (Pro+)

`GET /v1/webhooks`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/v1/webhooks`
- Auth: API key in header `X-Api-Key`

Never includes `secret` — that's only ever returned once, at creation.

## Response `200`

Successful Response

- WebhookListResponse
  - `data` WebhookSubscription[], required
    - `id` string, required
    - `url` string, required
    - `filter` object, required
    - `is_active` boolean, required
    - `created_at` string, date-time, required
    - `secret` string, nullable
  - `meta` Meta, required
    - `request_id` string, required
    - `taxonomy_version` string, required
    - `tier` 'free' | 'pro' | 'enterprise', required

---

[API](https://skmtc.dev/scoopkit/apis/scoopkit-api.md) · [All operations](https://skmtc.dev/scoopkit/apis/scoopkit-api/llms.txt) · [OpenAPI document](https://skmtc.dev/scoopkit/apis/scoopkit-api/revisions/18068781261d?raw)