---
title: "Query current webhook endpoints"
method: GET
path: "/merchants/{merchantId}/webhook"
tags: ["Webhooks"]
---

# Query current webhook endpoints

`GET /merchants/{merchantId}/webhook`

Returns the configured webhook endpoints for payouts and bank account verification notifications.

## Path parameters

- `merchantId` string, required — A unique merchant ID provided by Peach Payments in hexadecimal format.

## Response `200`

The configured webhook endpoints for the merchant.

- object
  - `webhookEndpoint` string — Payouts status notification endpoint. Empty string if not configured.
  - `banvEndpoint` string — Bank account verification update notification endpoint. Empty string if not configured.
  - `webhookOptions` WebhookOptions — Toggles for which notification types are sent to the payouts webhook URL.
    - `floatAllocationUpdates` boolean — When true, receive webhooks when a deposit is allocated to float (top-up).
    - `payoutStatusUpdates` boolean — When true, receive webhooks when payout status changes.

## Other responses

- `400` — There was an error with the request. Please fix the request and try again.
- `401` — The request is not authenticated. Please re-authenticate and provide a new token.
- `403` — The request is not authorised. Please contact your business administrator.

---

[API](https://skmtc.net/peachpayments/apis/checkout.md) · [All operations](https://skmtc.net/peachpayments/apis/checkout/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/peachpayments/checkout/versions/3a98165665f8/schema)