> For the complete documentation index, see [llms.txt](https://docs.ezeebit.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ezeebit.com/customer-accounts/customer-account-details.md).

# Customer Account Details

Get a customer account's balance and deposit addresses.

**Live:**

<mark style="color:green;">`POST`</mark> [<mark style="color:blue;">https://api.ezeebit.com/open/api/v1/customerAccount/details</mark>](https://api.ezeebit.com/open/api/v1/customerAccount/details)

**UAT:**

<mark style="color:green;">`POST`</mark> [<mark style="color:blue;">https://uat-api.ezeebit.com/open/api/v1/customerAccount/details</mark>](https://uat-api.ezeebit.com/open/api/v1/customerAccount/details)

## Headers

| Name                   | Type   | Required | Value                          |
| ---------------------- | ------ | -------- | ------------------------------ |
| Content-Type           | string | Y        | application/json               |
| Ezeebit-Timestamp      | long   | Y        | Unix timestamp in milliseconds |
| Ezeebit-Nonce          | string | Y        | 32 characters                  |
| Ezeebit-Certificate-SN | string | Y        | API key issued by Ezeebit Pay  |
| Ezeebit-Signature      | string | Y        | Uppercase SHA512 signature     |

## Request Body

```json
{
  "customerAccountId": "cust-1001"
}
```

## Form data

| Parameter         | Type   | Required | Description          |
| ----------------- | ------ | -------- | -------------------- |
| customerAccountId | string | Yes      | The account to read. |

`balance` is read live and is what the account can spend. A deposit that is still confirming, or a withdrawal in progress, is held separately and isn't included.

{% hint style="info" %}
**Deposit addresses can change.** If a deposit fails our compliance screening, it isn't credited. We retire the address it was sent to, issue a replacement — on Ethereum and BSC together, since they share an address — and email you. Read the addresses from this endpoint whenever you show them to your customer, rather than storing them.
{% endhint %}

## Response

| Status | Description                |
| ------ | -------------------------- |
| 200    | Account returned           |
| 10121  | Customer account not found |

{% tabs %}
{% tab title="200" %}

```json
{
  "code": 200,
  "msg": "success",
  "data": {
    "customerAccountId": "cust-1001",
    "accountName": "Customer 1001",
    "status": "ACTIVE",
    "wallets": [
      {
        "walletId": "5d0c7e2a-4b1f-4c8e-9a3d-2f6b8e1c4a70",
        "unit": "USDT",
        "balance": "250.00000000",
        "depositAddresses": [
          {
            "chainType": "TRX",
            "address": "TQ8nJ5bL2wVxK3pR7mYcH4dF9gS6tA1kPd"
          },
          {
            "chainType": "ETH",
            "address": "0x7a3f5e2b9c1d4a6e8f0b2c4d6e8a0b1c3d5ec91e"
          },
          {
            "chainType": "BSC",
            "address": "0x7a3f5e2b9c1d4a6e8f0b2c4d6e8a0b1c3d5ec91e"
          },
          {
            "chainType": "SOL",
            "address": "5hT3qLm8vXcR2nKp9dWf6yBzJa4sE7uGtN1oH8iCkVxQ"
          }
        ]
      }
    ]
  }
}
```

{% endtab %}

{% tab title="10121" %}

```json
{
  "code": 10121,
  "msg": "Customer account not found",
  "data": null
}
```

{% endtab %}
{% endtabs %}
