---
title: "Get Payment Account Balance History"
method: GET
path: "/v2/accounts/{accountId}/balances/history"
tags: ["Accounts | Admin"]
---

# Get Payment Account Balance History

`GET /v2/accounts/{accountId}/balances/history`

## Request

- Base URL: `https://ws.lemonway.fr/mb/env-name/prod/directkitrest`
- URL: `https://ws.lemonway.fr/mb/env-name/prod/directkitrest/v2/accounts/{accountId}/balances/history`
- Auth: none declared. Required headers: `Authorization`, `PSU-IP-Address`

Enter an `accountId` and specify the `atDate` parameter to return an account balance.  

**Important:** Payment account balances can not be viewed for special accounts SC **11** and LW **4** using the `accountId` parameter.

## Path parameters

- `accountId` string, required

## Query parameters

- `atDate` string

## Headers

- `Authorization` string, required
- `PSU-Accept-Language` string
- `PSU-IP-Address` string, required
- `PSU-User-Agent` string

## Response `200`

OK

- BalanceHistoryOutput
  - `balance` integer: Payment account balance.
  - `error` Error
    - `code` integer
    - `message` string
    - `psp` PSP
      - `message` string: Get the Error Message from PSP

## Other responses

- `401`: Unauthorized
- `500`: InternalServerError

---

[API](https://skmtc.dev/lemonway/apis/lemonway-directkit-api-2-0.md) - [All operations](https://skmtc.dev/lemonway/apis/lemonway-directkit-api-2-0/llms.txt) - [OpenAPI document](https://skmtc.dev/lemonway/apis/lemonway-directkit-api-2-0/revisions/82551a0a77b8?raw)