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

# List webhook subscriptions

`GET /webhooks/subscriptions`

## Request

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

Returns every webhook subscription in the API key's workspace,
newest first.

## Query parameters

- `cursor` string
- `limit` integer

## Response `200`

A page of subscriptions.

- object
  - `subscriptions` 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
  - `pagination` Pagination, required
    - `nextCursor` string, nullable, required: Pass this as `?cursor=` to fetch the next page. `null` when you've reached the last page.
    - `hasMore` boolean, required: True when more pages remain.

## Other responses

- `401`: Missing, malformed, expired, or revoked API key.
- `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)