---
title: "GET /webhooks"
method: GET
path: "/webhooks"
---

# GET /webhooks

`GET /webhooks`

## Request

- Base URL: `https://api.useanima.sh/v1`
- URL: `https://api.useanima.sh/v1/webhooks`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

## Query parameters

- `cursor` string: Opaque cursor from a previous response to fetch the next page
- `limit` integer: Maximum number of items to return per page (1–100, default 20)

## Response `200`

OK

- object: Paginated list of webhook subscriptions
  - `items` object[], required: Array of webhook resources in the current page
    - `id` string, required: Unique identifier for the webhook
    - `orgId` string, required: Organization that owns this webhook
    - `url` string, uri, required: HTTPS endpoint URL receiving webhook payloads
    - `events` string[], required: Event types this webhook is subscribed to
    - `active` boolean, required: Whether the webhook is currently active
    - `description` string, nullable, required: Human-readable label for this webhook
    - `consecutiveFailures` integer, required: Number of consecutive delivery failures across all events
    - `disabledReason` string, nullable, required: Reason the webhook was auto-disabled, null if manually disabled or active
    - `disabledAt` string, date-time, nullable, required: ISO 8601 timestamp when the webhook was auto-disabled
    - `createdAt` string, date-time, required: ISO 8601 timestamp when the webhook was created
    - `updatedAt` string, date-time, required: ISO 8601 timestamp when the webhook was last modified
    - `authType` 'NONE' | 'BEARER' | 'BASIC' | 'CUSTOM_HEADER', required: Auth scheme the platform presents to your endpoint (never includes the secret)
    - `authHeaderName` string, nullable, required: Header name for CUSTOM_HEADER auth; null for other schemes
    - `rateLimitPerMinute` integer, nullable, required: Per-endpoint delivery rate cap in requests/minute; null = unlimited
    - `maxAttempts` integer, nullable, required: Per-webhook max delivery attempts; null = platform default (3)
  - `pagination` object, required: Cursor-based pagination metadata
    - `nextCursor` string, nullable, required: Cursor to pass as the `cursor` parameter to retrieve the next page, or null if no more results
    - `hasMore` boolean, required: Whether additional pages of results are available

---

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