> ## 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 recipients

> List every recipient on your account

Paginated. Filter client-side — no server-side attribute filters.

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

## Headers

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

## Query parameters

<ParamField query="limit" type="integer">
  Page size. Default `10`, clamped to `[1, 200]`.
</ParamField>

<ParamField query="offset" type="integer">
  Pagination offset. Default `0`.
</ParamField>

## Response

Array of [recipients](/api-reference/recipients/get#response).

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "id": "8b1a4c1d-7a3c-4a08-94ad-9f1ef1e0c3a2",
      "email": "payments@acme-ph.com",
      "isBusiness": true,
      "businessName": "Acme Corp Philippines",
      "country": "PH",
      "currency": "PHP",
      "transferType": "fiat",
      "externalReference": { "vendor_id": "ACME-001" },
      "status": "accepted",
      "createdAt": "2026-06-09T10:00:00Z",
      "updatedAt": "2026-06-09T10:00:00Z"
    },
    {
      "id": "4c2b7e8f-3a3c-4a08-94ad-1234567890ab",
      "email": "treasury@acme-singapore.com",
      "isBusiness": true,
      "businessName": "Acme Singapore",
      "country": "SG",
      "transferType": "stablecoin",
      "walletAddresses": { "137": "0xAbc…", "42161": "0xAbc…" },
      "status": "accepted",
      "createdAt": "2026-06-09T10:00:00Z",
      "updatedAt": "2026-06-09T10:00:00Z"
    }
  ]
  ```
</ResponseExample>