---
title: "Retrieve account balances for a single account"
method: GET
path: "/pty/account/v1/accounts/{account_id}/balances"
tags: ["Ledger API - Balances"]
---

# Retrieve account balances for a single account

`GET /pty/account/v1/accounts/{account_id}/balances`

## Request

- Base URL: `https://api.uat.paymentology.com`
- URL: `https://api.uat.paymentology.com/pty/account/v1/accounts/{account_id}/balances`
- Auth: HTTP bearer

<ul>
<li class="docBullet">Retrieves the pending and available balances for a single account.</li>
</ul>

## Path parameters

- `account_id` string, required

## Response `200`

Successful Response

- AccountBalanceItem
  - `account_id` string, required: Account identifier
  - `account_name` string, required: Account name
  - `parent_account_id` string, nullable: Parent account identifier
  - `external_reference` string, nullable: External reference for the account
  - `currency` string, required: ISO 4217 currency code.
  - `pending_balance` string, required: Pending balance amount in minor units — in-flight transactions and authorization holds.
  - `available_balance` string, required: Available balance amount in minor units.
  - `created_at` string, date-time, required: Account creation date

## Other responses

- `400`: `BAD_REQUEST`: invalid parameter (listed in `details` for field validation errors).
- `401`: Missing or invalid access token: `UNAUTHORIZED`, `INVALID_CLIENT` or `INVALID_TENANT`.
- `403`: Access token rejected by the API gateway (for example, expired).
- `404`: `NOT_FOUND`: the account does not exist or does not belong to the client.
- `500`: `INTERNAL_SERVER_ERROR`: unexpected error.
- `503`: `INFRASTRUCTURE_ERROR`: temporary failure, retry later.

---

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