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

# List subscriptions

> List every webhook subscription on your account

All subscriptions on your account.

## Account limits

| Limit                                | Value           |
| ------------------------------------ | --------------- |
| Subscriptions per account            | 25              |
| Maximum payload size (JSON envelope) | 256 KB          |
| URL scheme                           | `https://` only |

Loopback, RFC1918 private, link-local, and known cloud metadata host/IP ranges are rejected at create time and at delivery time (DNS is re-resolved before every POST).

<Info>**Scope** `webhooks:read`</Info>

## Headers

<ParamField header="Authorization" type="string" required>
  API key.
</ParamField>

## Response

<ResponseField name="id" type="string">
  Subscription UUID.
</ResponseField>

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

<ResponseField name="events" type="string[]">
  Event types the subscription listens for (e.g. `payout.created`, `payout.status.updated`).
</ResponseField>

<ResponseField name="status" type="string">
  `active` or `paused`.
</ResponseField>

<ResponseField name="secretPrefix" type="string">
  First few characters of the signing secret, for partner-side identification. The plaintext is only ever returned by [Create](/api-reference/webhooks/subscriptions/create) and [Rotate](/api-reference/webhooks/subscriptions/rotate-secret).
</ResponseField>

<ResponseField name="label" type="string">
  Human-readable label shown in the dashboard. Never sent to your endpoint.
</ResponseField>

<ResponseField name="lastSuccessAt" type="string">
  ISO 8601 timestamp of the most recent 2xx delivery. `null` if none yet.
</ResponseField>

<ResponseField name="lastFailureAt" type="string">
  ISO 8601 timestamp of the most recent failed delivery. `null` if none yet.
</ResponseField>

<ResponseField name="createdAt" type="string">
  ISO 8601 timestamp.
</ResponseField>

<ResponseField name="updatedAt" type="string">
  ISO 8601 timestamp.
</ResponseField>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "id": "1c84203c-b4e3-40de-83a9-51bc0d9c991f",
      "url": "https://hooks.example.com/teel",
      "events": ["payout.created", "payout.status.updated"],
      "status": "active",
      "secretPrefix": "whsec_Pdt_BP",
      "label": "Production receiver",
      "lastSuccessAt": "2026-05-27T09:31:02Z",
      "lastFailureAt": null,
      "createdAt": "2026-05-27T09:30:00Z",
      "updatedAt": "2026-05-27T09:30:00Z"
    }
  ]
  ```
</ResponseExample>