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

# List webhooks

`GET /api/webhooks`

## Request

- Base URL: `https://api.zvid.io`
- URL: `https://api.zvid.io/api/webhooks`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

## Response `200`

Account endpoints and plan allowance

- WebhookList
  - `webhooks` Webhook[], required
    - `id` string, required
    - `url` string, required
    - `description` string
    - `events` string[], required
    - `status` 'active' | 'disabled', required
    - `secret` string: Returned by creation and single-webhook lookup; omitted from list/update responses.
    - `consecutiveFailures` integer
    - `lastSuccessAt` string, nullable
    - `lastFailureAt` string, nullable
    - `lastFailureReason` string, nullable
    - `createdAt` string
    - `updatedAt` string
  - `usage` WebhookUsage, required
    - `used` integer, required
    - `limit` integer, required
    - `planName` string, required

## Other responses

- `401`: Unauthorized

---

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