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

# List recipients

> List recipients

See [authentication, signing, data conventions, and errors](https://docs.stablepayfi.ai/en/api/global-accounts/overview). Regenerate the timestamp, nonce, and signature on every retry.

`GET /recipient` Lists recipients with optional type and currency filters, cursor paginated.

## Request headers

**Authorization** `string` *required*

Bearer API Key.

**X-StablePay-Timestamp** `string` *required*

Unix seconds, within five minutes of server time.

**X-StablePay-Nonce** `string` *required*

Unique per request, 16–64 characters.

**X-StablePay-Signature** `string` *required*

Lowercase hexadecimal HMAC-SHA256 signature for the exact request body.

## Request parameters

**merchant\_id** `string`

10 digits; omit for merchant apps, required for service-provider apps

**type** `string`

Filter by type

**currency** `string`

Filter by currency

**limit** `integer`

Page size, default 20, max 100

**next\_cursor** `string`

Cursor from the previous page

## Response

**recipients** `array` *required*

Recipients

**next\_cursor** `string`

Returned when more pages exist

**recipient\_id** `string` *required*

Recipient ID

**merchant\_id** `string` *required*

Merchant ID

**external\_recipient\_id** `string`

Business reference

**type** `string` *required*

`stablecoin_address` or `fiat_account`

**currency** `string` *required*

Payout currency

**is\_third\_party** `boolean` *required*

Whether a third party

**name** `string`

Display name

**network** `string`

Stablecoin network

**details** `object` *required*

Address and memo, or bank fields

**created** `integer` *required*

Creation time

**updated** `integer`

Update time

## Status and errors

400 on invalid parameters.

```bash cURL theme={"system"}
curl --request GET \
  --url "https://api.stablepay.co/api/v1/recipient" \
  --header "Authorization: Bearer <API_KEY>" \
  --header "X-StablePay-Timestamp: <TIMESTAMP>" \
  --header "X-StablePay-Nonce: <NONCE>" \
  --header "X-StablePay-Signature: <SIGNATURE>"
```

```javascript JavaScript theme={"system"}
const response = await fetch("https://api.stablepay.co/api/v1/recipient", {
  method: "GET",
  headers: {
    "Authorization": "Bearer <API_KEY>",
    "X-StablePay-Timestamp": "<TIMESTAMP>",
    "X-StablePay-Nonce": "<NONCE>",
    "X-StablePay-Signature": "<SIGNATURE>"
  }
});
console.log(await response.json());
```

```json 200 theme={"system"}
{
  "recipients": [
    {
      "recipient_id": "9000000080",
      "merchant_id": "2000000001",
      "type": "stablecoin_address",
      "currency": "USDC",
      "is_third_party": true,
      "name": "Supplier A",
      "network": "solana",
      "details": {
        "address": "4fYNw3dojWmQ4dXtSGE9epjRGy9pFSx62YymTvAVmRoz"
      },
      "created": 1718726401
    }
  ],
  "next_cursor": "eyJpZCI6IjkwMDAwMDAwODAifQ"
}
```


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