---
title: "Get account balances"
method: GET
path: "/v1/domains/{domainId}/accounts/{accountId}/balances"
tags: ["Accounts"]
---

# Get account balances

`GET /v1/domains/{domainId}/accounts/{accountId}/balances`

## Request

- Base URL: `https://docs.ripple.com` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.ripple.com/v1/domains/{domainId}/accounts/{accountId}/balances`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/ripple/apis/ripple-custody-api/docs/v1/domains/:domainId/accounts/:accountId/balances/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `domainId` string, uuid, required
- `accountId` string, uuid, required

## Query parameters

- `limit` integer
- `startingAfter` string, uuid
- `sortBy` 'id' | 'tickerId' | 'totalAmount' | 'reservedAmount' | 'quarantinedAmount' | 'lastUpdatedAt'
- `sortOrder` 'ASC' | 'DESC'
- `ticker.id` string[]
- `ticker.name` string[]
- `ticker.symbol` string[]
- `ticker.ledgerId` string[]
- `ticker.validationStatus` 'Validated' | 'NonValidated'
- `ticker.lock` CoreLockStatus[]

## Response `200`

- CoreBalancesCollection
  - `items` CoreBalance[], required
    - `accountReference` CoreAccountReference, required
      - `id` string, uuid, required
      - `domainId` string, uuid, required
    - `tickerId` string, uuid, required
    - `totalAmount` string, required: This field is a large integer that can be negative, zero, or positive. It is represented as a string because it may contain value that cannot be expressed with JSON number without a loss of precision.
    - `reservedAmount` string, required: This field is a large integer that can be positive or zero. It is represented as a string because it may contain value that cannot be expressed with JSON number without a loss of precision.
    - `quarantinedAmount` string, required: This field is a large integer that can be positive or zero. It is represented as a string because it may contain value that cannot be expressed with JSON number without a loss of precision.
    - `availableAmount` string, required: This field is a large integer that can be negative, zero, or positive. It is represented as a string because it may contain value that cannot be expressed with JSON number without a loss of precision.
    - `lastUpdatedAt` string, date-time, required
  - `count` integer, required
  - `currentStartingAfter` string
  - `nextStartingAfter` string

## Other responses

- `400`: One of: Domain locked (DomainLockedError); Requester locked (RequesterLockedError)
- `401`: One of: Invalid JWT (InvalidJwtError); User not authorized (PermissionDeniedError)
- `404`: Entity or Domain not found (EntityNotFoundError)
- `409`: One of: Account not processed (AccountNotProcessed); Account not ready yet (AccountNotReady)

---

[API](https://skmtc.dev/ripple/apis/ripple-custody-api.md) - [All operations](https://skmtc.dev/ripple/apis/ripple-custody-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ripple/apis/ripple-custody-api/revisions/c6f0ad6b70c0?raw)