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

# List webhook endpoints

`GET /v1/webhooks`

## Request

- Base URL: `https://api.vivideo.ai`
- URL: `https://api.vivideo.ai/v1/webhooks`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/vivideo/apis/vivideo-api/docs/v1/webhooks/get.ts> (a function with typed inputs; its response is checked against the schema)

## Response `200`

Registered endpoints (secrets are never re-shown).

- object
  - `object` string
  - `data` WebhookEndpoint[]
    - `id` string
    - `object` string
    - `url` string
    - `events` string[]
    - `status` string
    - `created_at` integer
    - `secret` string: Signing secret (whsec_...) — returned ONLY at creation.

## Other responses

- `401`: Missing, malformed or revoked API key (`missing_api_key`, `invalid_api_key`, `api_key_revoked`).

---

[API](https://skmtc.dev/vivideo/apis/vivideo-api.md) - [All operations](https://skmtc.dev/vivideo/apis/vivideo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/vivideo/apis/vivideo-api/revisions/6e8a47e72b46?raw)