---
title: "Get Subscription"
method: GET
path: "/webhooks/subscriptions/{subscription_id}"
tags: ["webhooks"]
---

# Get Subscription

`GET /webhooks/subscriptions/{subscription_id}`

## Request

- Base URL: `https://api.airweave.ai`
- URL: `https://api.airweave.ai/webhooks/subscriptions/{subscription_id}`
- Auth: API key in header `x-api-key`

Retrieve a specific webhook subscription with its recent delivery attempts.

Returns the subscription configuration along with a history of message delivery
attempts. This is useful for debugging delivery issues or verifying that your
endpoint is correctly receiving events.

Use `include_secret=true` to also retrieve the signing secret for webhook
signature verification. Keep this secret secure.

## Path parameters

- `subscription_id` string, required: The unique identifier of the subscription to retrieve (UUID).

## Query parameters

- `include_secret` boolean: Include the signing secret for webhook signature verification. Keep this secret secure and use it to verify the 'svix-signature' header.

## Response `200`

Subscription with delivery attempts

- WebhookSubscriptionDetail: Full subscription detail, including delivery attempts and signing secret. Returned by ``GET /subscriptions/{id}`` only.
  - `id` string, required: Unique identifier for this subscription (UUID format)
  - `url` string, required: The URL where webhook events are delivered
  - `filter_types` string[], nullable: Event types this subscription is filtered to receive. See EventType enum for all available types.
  - `disabled` boolean: Whether this subscription is currently disabled. Disabled subscriptions do not receive event deliveries.
  - `description` string, nullable: Optional human-readable description of this subscription
  - `created_at` string, date-time, required: When this subscription was created (ISO 8601 format, UTC)
  - `updated_at` string, date-time, required: When this subscription was last updated (ISO 8601 format, UTC)
  - `health_status` 'healthy' | 'degraded' | 'failing' | 'unknown': Health status of a webhook subscription based on recent delivery attempts.
  - `delivery_attempts` DeliveryAttempt[], nullable: Recent delivery attempts for this subscription.
    - `id` string, required: Unique identifier for this delivery attempt
    - `message_id` string, required: The event message that was being delivered
    - `endpoint_id` string, required: The subscription endpoint this was delivered to
    - `response` string, nullable: The response body returned by your webhook endpoint (truncated to 1KB)
    - `response_status_code` integer, required: HTTP status code returned by your webhook endpoint. 2xx codes indicate success; other codes trigger retries.
    - `status` string, required: Delivery status: `success` (2xx response), `pending` (awaiting delivery), or `failed` (non-2xx response or timeout)
    - `timestamp` string, date-time, required: When this delivery attempt occurred (ISO 8601 format, UTC)
    - `url` string, nullable: The URL that was called
  - `secret` string, nullable: The signing secret for webhook signature verification. Only included when include_secret=true is passed to the API. Keep this secret secure.

## Other responses

- `404`: Subscription Not Found
- `422`: Validation Error
- `429`: Rate Limit Exceeded

## Changes

> 63 revisions in range; 2 not diffed.

- **2026-03-12** `a944d305e967`: 1 info
  - added the optional property `health_status` to the response with the `200` status
- **2026-02-14** `dcef44679b67`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/airweave-ai/apis/airweave/changes/webhooks/subscriptions/:subscription_id/get.md)

---

[API](https://skmtc.dev/airweave-ai/apis/airweave.md) - [All operations](https://skmtc.dev/airweave-ai/apis/airweave/llms.txt) - [OpenAPI document](https://skmtc.dev/airweave-ai/apis/airweave/revisions/bf410c28c0c6?raw)