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

# Query current webhook endpoints

`GET /merchants/{merchantId}/webhook`

## Request

- Base URL: `https://sandbox-payouts.peachpayments.com/api`
- URL: `https://sandbox-payouts.peachpayments.com/api/merchants/{merchantId}/webhook`
- Auth: HTTP bearer

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.dev/peachpayments/apis/payouts.md) - [All operations](https://skmtc.dev/peachpayments/apis/payouts/llms.txt) - [OpenAPI document](https://skmtc.dev/peachpayments/apis/payouts/revisions/a53677a021ef?raw)