---
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

---

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