---
title: "Get all Payment Account Balances"
method: GET
path: "/v2/accounts/balances"
tags: ["Accounts | Admin"]
---

# Get all Payment Account Balances

`GET /v2/accounts/balances`

## Request

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

Use `GetBalances` to get all payment accounts where the balance has changed since the input date, or all the balances of payment accounts with internal ID between payment `accountIdStart` and payment `accountIdEnd`.

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

## Query parameters

- `updateDate` string
- `internalAccountIdStart` integer
- `internalAccountIdEnd` integer
- `page` integer
- `limit` integer

## Headers

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

## Response `200`

OK

- AccountBalanceOutput
  - `accounts` AccountBalance[]
    - `id` string: Payment account ID
    - `balance` integer: Payment account balance
    - `status` 2 | 3 | 5 | 6 | 7 | 8 | 10 | 12 | 13 | 14 | 15 | 16: Payment account status<br/>2 = Registered, KYC incomplete.<br/>3 = Registered, rejected KYC.<br/>5 = Registered, KYC 1 (status given at registration).<br/>6 = Registered, KYC 2.<br/>7 = Registered, KYC 3.<br/>8 = Registered, expired KYC.<br/>10 = Blocked.<br/>12 = Closed.<br/>13 = Registered, status is being updated from KYC 2 to KYC 3.<br/>14 = One-time customer.<br/>15 = Special account for crowdlending.<br/>16 = Technical account.<br/>
  - `_links` Links
    - `first` Link
      - `href` string
      - `templated` boolean
      - `method` string
      - `type` string
      - `deprecation` string
      - `name` string
      - `profile` string
      - `title` string
      - `hreflang` string
    - `last` Link
      - `href` string
      - `templated` boolean
      - `method` string
      - `type` string
      - `deprecation` string
      - `name` string
      - `profile` string
      - `title` string
      - `hreflang` string
    - `previous` Link
      - `href` string
      - `templated` boolean
      - `method` string
      - `type` string
      - `deprecation` string
      - `name` string
      - `profile` string
      - `title` string
      - `hreflang` string
    - `next` Link
      - `href` string
      - `templated` boolean
      - `method` string
      - `type` string
      - `deprecation` string
      - `name` string
      - `profile` string
      - `title` string
      - `hreflang` string
    - `self` Link
      - `href` string
      - `templated` boolean
      - `method` string
      - `type` string
      - `deprecation` string
      - `name` string
      - `profile` string
      - `title` string
      - `hreflang` string
  - `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)