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

# List Webhook Subscriptions

> List the webhook subscriptions registered under a Brale account.

```
GET /accounts/{account_id}/webhooks
```

Required scope: `webhooks:read`.

The `sharedSecret` is not returned by this endpoint.

## Path parameters

| Name         | Type   | Description                                             |
| ------------ | ------ | ------------------------------------------------------- |
| `account_id` | string | The Brale account whose subscriptions you want to list. |

## Example request

```bash theme={null}
curl https://api.brale.xyz/accounts/{account_id}/webhooks \
  -H "Authorization: Bearer {access_token}"
```

## Example response

```json theme={null}
{
  "subscriptions": [
    {
      "id": "3D3jNzs2r7Sf78qtYpRe1biscLG",
      "events": ["transfer.completed"],
      "url": "https://your-app.example.com/webhooks/brale",
      "status": "active"
    }
  ]
}
```

See the [Webhooks overview](/webhooks/overview) for how subscriptions are scoped to a Brale account and environment.