---
title: "Get customer balance"
method: GET
path: "/customers/{id}/balance"
tags: ["Customer"]
---

# Get customer balance

`GET /customers/{id}/balance`

Get the aggregated estimated balance across all customer wallets/assets.

## Path parameters

- `id` string, required

## Query parameters

- `estimatedBalanceCurrencyCode` string

## Response `200`

The request has succeeded.

- CustomerBalanceAggregate — A customer's estimated total balance, aggregated across all of their wallets and assets.
  - `data` object, required
    - `customerId` string, required — Public TypeID, e.g. `txn_01h455vb4pex5vsknk084sn02q`; legacy UUID suffixes are accepted until non-v7 rows are retired.
    - `estimatedBalanceValue` string, required — Wire-safe decimal string that preserves trailing zeros on the wire.
    - `estimatedBalanceCurrencyCode` string, required — Currency code used for `estimatedBalanceValue`.
    - `updatedAt` string, date-time — Most recent provider balance timestamp included in the aggregate. Omitted when no provider balance timestamps were available to aggregate.

## Other responses

- `400` — The server could not understand the request due to invalid syntax.
- `401` — Access is unauthorized.
- `404` — The server cannot find the requested resource.
- `422` — Client error
- `502` — Server error
- `503` — Service unavailable.

---

[API](https://skmtc.net/polygon-technology/apis/polygon-oms-public-api.md) · [All operations](https://skmtc.net/polygon-technology/apis/polygon-oms-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/polygon-technology/polygon-oms-public-api/revisions/18fdaebf64e5/schema)