---
title: "List webhooks"
method: GET
path: "/v1/webhooks"
tags: ["Webhooks"]
---

# List webhooks

`GET /v1/webhooks`

Get all webhooks for your business with delivery statistics. **Requires a secret key (sk_).** Public keys (pk_) will receive a 403 error.

## Response `200`

List of webhooks

- object — List of webhooks
  - `data` object[]
    - `id` string — Unique webhook identifier
    - `url` string, uri — Endpoint URL that receives events
    - `events` string[] — Event types this webhook subscribes to
    - `description` string, nullable — Optional description
    - `isActive` boolean — Whether the webhook is active
    - `healthStatus` 'HEALTHY' | 'DEGRADED' | 'UNHEALTHY' — Health status from circuit breaker
    - `consecutiveFailures` integer — Number of consecutive delivery failures
    - `lastHealthChange` string, date-time, nullable — When health status last changed
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
    - `stats` object — Delivery statistics for this webhook
      - `total` integer — Total events sent
      - `delivered` integer — Successfully delivered
      - `failed` integer — Failed after retries
      - `pending` integer — Currently retrying
  - `count` integer — Total webhooks

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.net/usedrip/apis/drip-api.md) · [All operations](https://skmtc.net/usedrip/apis/drip-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/usedrip/drip-api/revisions/2cb1567969ca/schema)