> ## 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 all accounts and balances for the target merchant

> List all accounts and balances for the target merchant

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 /account` Returns every account and balance for the target merchant; no pagination or filters.

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

## Response

**object** `string` *required*

Always list

**data** `array` *required*

Array of account objects

**as\_of** `integer` *required*

Observation time

**account\_no** `string` *required*

8-digit account number; keep leading zeros

**account\_name** `string` *required*

Display name

**currency** `string` *required*

Currency or asset code

**status** `string` *required*

active or restricted

**is\_system\_default** `boolean` *required*

System default account

**editable** `boolean` *required*

Whether renaming is allowed

**available\_amount** `integer` *required*

Available balance, smallest unit

**frozen\_amount** `integer` *required*

Frozen or reserved balance

**total\_amount** `integer` *required*

Total = available + frozen

**created** `integer` *required*

Creation time, Unix seconds

## Status and errors

401 on auth failure; 403 when the app cannot access the merchant.

```bash cURL theme={"system"}
curl --request GET \
  --url "https://api.stablepay.co/api/v1/account" \
  --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/account", {
  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"}
{
  "object": "list",
  "data": [
    {
      "account_no": "00000001",
      "account_name": "Default Account",
      "currency": "USDT",
      "status": "active",
      "is_system_default": true,
      "editable": false,
      "available_amount": 10000,
      "frozen_amount": 2000,
      "total_amount": 12000,
      "created": 1788998400
    }
  ],
  "as_of": 1789084800
}
```


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