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

# List webhook endpoints

`GET /webhooks`

## Request

- Base URL: `https://app-sandbox.resolvepay.com/api`
- URL: `https://app-sandbox.resolvepay.com/api/webhooks`
- Auth: one of:
  - HTTP bearer
  - HTTP basic
- TypeScript: <https://skmtc.dev/resolvepay/apis/resolve-api-reference/docs/webhooks/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a list of all configured webhook endpoints for the merchant account.

## Query parameters

- `limit` integer
- `page` string

## Response `200`

An object with an array of results containing up to the limit. If no subscriptions are found, the results array will be empty.

- object
  - `count` integer: Total number of webhook endpoint subscriptions
  - `page` integer: Current page number
  - `limit` integer: Number of results per page
  - `results` WebhookEndpoint[]: Array of webhook endpoint objects. Each object represents one endpoint-topic subscription. If an endpoint is subscribed to multiple topics, it will appear multiple times in the array.
    - `id` string: Unique identifier for the webhook endpoint
    - `merchant_id` string: The merchant ID associated with this webhook endpoint
    - `endpoint_url` string, uri: The HTTPS URL where webhook events will be sent
    - `topic` object: The event topic this endpoint is subscribed to
      - `name` string: The event topic name
      - `description` string: Human-readable description of the event topic
    - `created_at` string, date-time: When this webhook endpoint subscription was created
    - `updated_at` string, date-time: When this webhook endpoint subscription was last updated

## Other responses

- `400`: Bad request error
- `401`: Unauthorized error
- `429`: Rate limit error

---

[API](https://skmtc.dev/resolvepay/apis/resolve-api-reference.md) - [All operations](https://skmtc.dev/resolvepay/apis/resolve-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/resolvepay/apis/resolve-api-reference/revisions/c62edc454aaa?raw)