---
title: "List webhook subscriptions"
method: GET
path: "/api-regulated/v1/webhook-subscriptions"
tags: ["Webhooks"]
---

# List webhook subscriptions

`GET /api-regulated/v1/webhook-subscriptions`

## Request

- Base URL: `https://api.currencyguard.com`
- URL: `https://api.currencyguard.com/api-regulated/v1/webhook-subscriptions`
- Auth: OAuth 2 (implicit, authorization URL `https://auth.currencyguard.com/oauth2/authorize`, scopes: `regulated.api-clients.canManageWebhooks`)

Returns all subscriptions for the authenticated regulated entity, with delivery health fields.

**Required entitlement:** `regulated.api-clients.canManageWebhooks`  
_Entitles the regulated user to create, view, update, rotate, delete, and replay webhook subscriptions for B2B event delivery_

## Response `200`

Subscriptions retrieved

- WebhookSubscriptionDTO[]
  - `id` string, uuid: ID for this webhook subscription
  - `subscriptionName` string: Human-readable name for this subscription, unique per regulated entity
  - `endpointUrl` string: HTTPS endpoint to which signed event payloads are POSTed
  - `status` 'ACTIVE' | 'PAUSED' | 'DISABLED' | 'DELETED': Status of this subscription
  - `lastEventSequence` integer: Highest event sequence number delivered to this subscription. -1 means nothing delivered yet.
  - `lastPushAt` string: Timestamp of the most recent delivery attempt in UTC
  - `lastPushStatus` integer: HTTP status code returned by the most recent delivery attempt
  - `lastErrorMessage` string: Error message from the most recent failed delivery attempt
  - `consecutiveFailures` integer: Number of consecutive delivery failures. Reset to 0 on success; subscription auto-pauses when the configured threshold is reached.
  - `pausedAt` string: Timestamp when this subscription was paused (auto or manual) in UTC
  - `updatedAt` string: Timestamp of the last update in UTC
  - `createdAt` string: Timestamp of creation in UTC

## Other responses

- `401`: Not authenticated — [`security/authentication-failed`](/problems/security/authentication-failed/)
- `403`: Not authorized — [`security/insufficient-permissions`](/problems/security/insufficient-permissions/)
- `500`: Server error — [`server/internal-error`](/problems/server/internal-error/)

---

[API](https://skmtc.dev/currencyguard/apis/currencyguard-trading-system-api-external.md) · [All operations](https://skmtc.dev/currencyguard/apis/currencyguard-trading-system-api-external/llms.txt) · [OpenAPI document](https://skmtc.dev/currencyguard/apis/currencyguard-trading-system-api-external/revisions/a1f3f854190d?raw)