---
title: "Get an account's balances history by ID"
method: GET
path: "/accounts/{account_id}/balances/history"
tags: ["Accounts"]
---

# Get an account's balances history by ID

`GET /accounts/{account_id}/balances/history`

## Request

- The document declares no server URL.
- Auth: one of:
  - API key in header `X-Ledger-API-User`
  - API key in header `X-Ledger-API-User` and API key in header `X-Ledger-API-Key`
  - API key in header `X-Ledger-API-User` and `Ledger_Store_Auth_Token` (a scheme the document does not define)
  - API key in header `X-Ledger-API-User` and API key in header `X-Ledger-API-Key` and `Ledger_Store_Auth_Token` (a scheme the document does not define)

This method returns the account's balances history that matches the entered ID.

## Path parameters

- `account_id` integer, required

## Query parameters

- `end` string, date-time, nullable
- `start` string, date-time, nullable

## Response `200`

Account object

- AccountBalancesHistory
  - `account_index` integer, required
  - `balances` AccountBalancesHistoryEntry[], required
    - `date` string, required
    - `value` string, nullable
  - `currency` CurrencyInfo, required
    - `magnitude` integer, required
    - `name` string, required
    - `network` string, required
    - `token_address` string, nullable

## Other responses

- `501`: Not supported for this currency

---

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