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

## 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.net/ripple/apis/ripple-custody-api.md) · [All operations](https://skmtc.net/ripple/apis/ripple-custody-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ripple/ripple-custody-api/revisions/0b55c0ddf07a/schema)