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

# Get all merchant webhooks

> Retrieve all merchant webhooks via the Atoa Webhooks API, request parameters, response schema and code samples in cURL, Python, JavaScript, PHP, Go and Java.

> [!WARNING]
>
> **v1 Legacy API** — Returns a flat list with one entry per event subscription. For new integrations, use [List Endpoints (v2)](https://docs.paywithatoa.com/api-reference/webhook/v2/list-endpoints.md) which returns paginated endpoint objects with all subscribed events grouped per endpoint.

Returns all active webhook subscriptions for your business account.

### Authorization

Bearer `<token>`

**Response**

Array Of Objects

**webhookId** `string`

Unique identifier for the webhook.

**url** `string`

The registered webhook URL.

**event** `string`

The subscribed event type.

```json 200 theme={null}
[
  {
    "webhookId": "4a124f25-fe8d-47a0-92c8-16d94cbfe24c",
    "url": "https://api/endpoint",
    "event": "PAYMENTS_STATUS"
  },
  {
    "webhookId": "8b3f6a12-cd45-4e89-ab12-7d9e3f1c5a08",
    "url": "https://api/endpoint",
    "event": "POS_PAYMENT_STATUS"
  }
]
```

```json 401 theme={null}
{
  "name": "UNAUTHORIZED",
  "message": "Unauthorized",
  "status": 401,
  "errors": "[]"
}
```


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