---
title: "Get a webhook subscription"
method: GET
path: "/webhooks/subscriptions/{id}"
tags: ["Webhooks"]
---

# Get a webhook subscription

`GET /webhooks/subscriptions/{id}`

## Request

- Base URL: `https://services.certseal.com/api/v1`
- URL: `https://services.certseal.com/api/v1/webhooks/subscriptions/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Response `200`

The subscription.

- object
  - `subscription` WebhookSubscription, required
    - `id` string, required
    - `url` string, uri, required: The customer-supplied URL that receives signed POSTs. Always uses `https` in production.
    - `events` WebhookEventType[], required
    - `status` 'active' | 'suspended', required: `suspended` once 20 consecutive deliveries have failed. Re-activate from the web app after fixing your endpoint.
    - `secretTail` string, required: Last 4 chars of the signing secret for UI rendering ("wh_sec_xxxx...wxyz"). The full secret is only returned by `createWebhookSubscription` / `rotateWebhookSubscriptionSecret`.
    - `failureCount` integer, required: Consecutive failed deliveries since the last success.
    - `lastFiredAt` string, date-time, nullable, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required

## Other responses

- `401`: Missing, malformed, expired, or revoked API key.
- `404`: The requested resource was not found in this workspace.
- `429`: Too many requests for this API key. Honour the `Retry-After` response header (seconds) or the `detail.retryAfter` field.

---

[API](https://skmtc.dev/certseal/apis/certseal-com-api.md) · [All operations](https://skmtc.dev/certseal/apis/certseal-com-api/llms.txt) · [OpenAPI document](https://skmtc.dev/certseal/apis/certseal-com-api/revisions/9097f49f49f5?raw)