> ## Documentation Index
> Fetch the complete documentation index at: https://developers.paychoice.com.au/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve webhooks for a merchant

Returns the webhook registrations for a merchant as an array.

> [!WARNING]
>
> Requires **agency-level credentials**. A merchant-level credential receives HTTP `400`.

`webhook_secret` is not included.

```json 200 theme={null}
[
  {
    "id": "0f6a1c2d-8e4b-4a7c-9d3e-5b2f1a6c8d90",
    "merchant_guid": "315564b9-b863-4016-8c53-02c9d8cc80b7",
    "webhook_url": "https://your-app.example.com/paychoice/webhook",
    "created_date": "2026-11-04T02:30:00.000Z",
    "created_by": "agency-user",
    "updated_date": null,
    "updated_by": null,
    "active": true
  }
]
```


## OpenAPI

````yaml GET /api/v5/merchantwebhooks/{merchantGUID}
openapi: 3.0.1
info:
  title: Paychoice
  version: v5
servers: []
security:
  - basic: []
paths:
  /api/v5/merchantwebhooks/{merchantGUID}:
    get:
      tags:
        - MerchantWebhook
      parameters:
        - name: merchantGuid
          in: path
          required: true
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: OK
components:
  securitySchemes:
    basic:
      type: http
      description: Basic Authorization header using the Bearer scheme.
      scheme: basic

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.