---
title: "Read a client's balances"
method: GET
path: "/client/balance"
tags: ["accounts"]
---

# Read a client's balances

`GET /client/balance`

## Request

- The document declares no server URL.
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/hevn-inc/apis/hevn-api/docs/client/balance/get.ts> (a function with typed inputs; its response is checked against the schema)

One row per account the client holds: the tokens on the smart wallet of the client selected by `X-Hevn-Account`, plus any custodial balance. `USDC_ARB` is USDC on Arbitrum at the same wallet address; it is turned on with the client's first balance read. A custodial row is read live from the provider that holds it and is left out when that provider cannot be reached.

## Headers

- `X-Hevn-Account` string, required: The selected client account, as a `cl_…` id.

## Response `200`

Successful Response

- ClientBalanceView
  - `clientId` string, required: Account associated with this balance.
  - `baseSmartWallet` string, nullable: Base smart-wallet address controlled by the account.
  - `accounts` AccountBalanceView[]: One entry per account the client holds a balance on.
    - `account` 'USDC' | 'EURC' | 'RD' | 'USDC_ARB' | 'FDIC_USD' | 'FDIC_EUR' | 'KYC_CARDS', required
    - `balance` string, required: Available balance on this account.
    - `usdValue` string, required: Indicative USD value of this balance.
  - `totalUsd` string, required: Indicative total balance converted to USD.

## Other responses

- `422`: Request validation failed

## Changes

- **2026-11-12** `299a3aa6f521`: 2 warning, 2 info
  - added the new `FDIC_EUR` enum value to the `accounts/items/account` response property for the response status `200`
  - added the new `verification_not_applicable` enum value to the `error/code` response property for the response status `422`
  - removed the `phone_required` enum value from the `error/code` response property for the response status `422`
  - removed the `rail_requirements_unmet` enum value from the `error/code` response property for the response status `422`
- **2026-10-23** `a02795de2d2b`: 12 warning, 5 info
  - deleted the `header` request parameter `x-api-key`
  - added the new `KYC_CARDS` enum value to the `accounts/items/account` response property for the response status `200`
  - added the new `RD` enum value to the `accounts/items/account` response property for the response status `200`
  - added the new `USDC_ARB` enum value to the `accounts/items/account` response property for the response status `200`
  - …13 more
- **2026-10-20** `19eb00e9f258`: 1 info
  - removed the `phone_in_use` enum value from the `error/code` response property for the response status `422`
- **2026-10-20** `bd6c9d69540e`: 1 warning
  - added the new `phone_in_use` enum value to the `error/code` response property for the response status `422`
- **2026-10-20** `19eb00e9f258`: 1 info
  - removed the `document_fields_missing` enum value from the `error/code` response property for the response status `422`

[Operation history](https://skmtc.dev/hevn-inc/apis/hevn-api/changes/client/balance/get.md)

---

[API](https://skmtc.dev/hevn-inc/apis/hevn-api.md) - [All operations](https://skmtc.dev/hevn-inc/apis/hevn-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hevn-inc/apis/hevn-api/revisions/299a3aa6f521?raw)