---
title: "List webhook subscriptions"
method: POST
path: "/api/service/webhook-subscription/list"
tags: ["Webhook-Subscription"]
---

# List webhook subscriptions

`POST /api/service/webhook-subscription/list`

Lists all webhook subscriptions that are registered for the merchant. The results are paginated and provided in chronological order.

## Request body

- ListRequestDto
  - `limit` number — The maximum number of webhook subscriptions to return
  - `skip` number — The number of webhook subscriptions to skip

## Response `200`

Returns a list of webhook subscriptions.

- ListResponseDto
  - `items` object[], required — Array of webhook subscription objects
    - `id` unknown, required
    - `merchant` unknown, required
    - `merchantApp` unknown, required
    - `url` string, required
    - `events` string[], required
    - `createdAt` unknown, required
    - `updatedAt` unknown, required
  - `skip` number, required — The number of webhook subscriptions skipped
  - `hasNext` boolean, required — Whether there are more webhook subscriptions to retrieve
  - `count` number, required — The total number of webhook subscriptions

## Changes

> 48 revisions in range; 2 could not be searched.

- **2026-04-07** `b58ce3f5ffe3` — 1 breaking
  - removed the required property `items/items/apiSurface` from the response with the `200` status
- **2026-04-01** `c2edd9a4d3cf` — 1 info
  - added the required property `items/items/apiSurface` to the response with the `200` status
- **2025-11-12** `fd2fa66d08ac` — 3 warning
  - added the new `fx.failed` enum value to the `items/items/events/items/` response property for the response status `200`
  - added the new `fx.initiated` enum value to the `items/items/events/items/` response property for the response status `200`
  - added the new `fx.succeeded` enum value to the `items/items/events/items/` response property for the response status `200`
- **2025-10-02** `1177ad83c85f` — 4 info
  - removed the `mandate_revoked` enum value from the `items/items/events/items/` response property for the response status `200`
  - removed the `mandate_setup_failed` enum value from the `items/items/events/items/` response property for the response status `200`
  - removed the `mandate_setup_started` enum value from the `items/items/events/items/` response property for the response status `200`
  - removed the `mandate_setup_succeeded` enum value from the `items/items/events/items/` response property for the response status `200`

[Change history](https://skmtc.dev/augustus/apis/ivy-api/changes/api/service/webhook-subscription/list/post.md)

---

[API](https://skmtc.dev/augustus/apis/ivy-api.md) · [All operations](https://skmtc.dev/augustus/apis/ivy-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/augustus/ivy-api/revisions/c3055fc06ca3/schema)