> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.paywithatoa.co.uk/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)](/api-reference/Webhook/v2/listEndpoints) which returns paginated endpoint objects with all subscribed events grouped per endpoint.
</Warning>

Returns all active webhook subscriptions for your business account.

### Authorization

Bearer `<token>`

**Response**

<ResponseField name="" type="array">
  Array Of Objects

  <Expandable>
    <ResponseField name="webhookId" type="string">
      Unique identifier for the webhook.
    </ResponseField>

    <ResponseField name="url" type="string">
      The registered webhook URL.
    </ResponseField>

    <ResponseField name="event" type="string">
      The subscribed event type.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```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": "[]"
  }
  ```
</ResponseExample>