---
title: "GET /webhooks/{id}"
method: GET
path: "/webhooks/{id}"
---

# GET /webhooks/{id}

`GET /webhooks/{id}`

## Request

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

## Path parameters

- `id` string, required: Unique webhook identifier

## Response `200`

OK

- object: Webhook subscription resource
  - `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)

---

[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)