---
title: "Get Detailed Payments Accounts Data"
method: POST
path: "/v2/accounts/retrieve"
tags: ["Accounts | Admin"]
---

# Get Detailed Payments Accounts Data

`POST /v2/accounts/retrieve`

Lets your system to get detailed payment account information including: 
payment account balance, account type, if the account is blocked, and account email address.  
Fill at least one search field.

## Query parameters

- `page` integer

## Headers

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

## Request body

- AccountDetailsBatchInput
  - `accounts` WalletDetailsInput[]
    - `accountid` string
    - `email` string

## Response `200`

OK

- AccountDetailsBatchOutput
  - `accounts` AccountDetails[]
    - `id` string — Payment Account ID
    - `internalId` integer — Internal ID given by Lemonway (ID displayed on the Dashboard)
    - `clientTitle` string — Client Title
    - `firstname` string — Holder's First Name
    - `lastname` string — Holder's Last Name
    - `balance` integer — Payment Account Balance Amount
    - `email` string — Email
    - `status` integer — | Status Code | Payment Account Status | |-----------------------------------------------------------------|----------------------------------------------------------------| | -1 | Wallet SC | | 2 | Registered, not verified: missing document(s) | | 3 | Registered, not verified: document(s) rejected | | 5 | Registered, not verified: KYC 1 (status given at registration) | | 6 | Registered and verified: KYC 2 | | 7* | Registered and verified by previous PSP: KYC 3 | | 8 | Registered, not verified: expired document(s) | | 10 | Blocked | | 12 | Closed | | 13* | Registered, status is being updated from KYC 2 to KYC 3 | | 14* | One-time customer | | 15* | Special wallet for crowdlending | | 16* | Technical wallet | | *these status may or may not be used depending on your business | |
    - `isblocked` boolean — Indicates if Account is blocked or not: 0: Not blocked 1: Blocked
    - `isRestricted` boolean — Indicates if Account is restricted or not: false: Not restricted true: Restricted
    - `accountType` integer — Indicates Account type: 0: Individual 1: Legal
    - `company` Company
      - `name` string — Company name (at least one alphabethic character is required)
      - `description` string — Company description
      - `websiteUrl` string — Website URL
      - `identificationNumber` string — Company identification number
    - `adresse` Address
      - `street` string — Client number and street
      - `postCode` string — Client Postcode/ZIP
      - `city` string — Client city
      - `country` string — Client country using ISO 3166-1 alpha-3
    - `birth` Birth
      - `date` string — Client Date of Birth
      - `city` string — Client City of Birth
      - `Country` string — Client Country of Birth, using ISO 3166-1 alpha-3. Three-letter country code, for example: FRA (France), GBR (United Kingdom of Great Britain and Northern Ireland)
    - `nationality` string — Nationality
    - `phoneNumber` string — Phone number with MSISDN format
    - `mobileNumber` string — Mobile phone number with MSISDN format
    - `isDebtor` boolean — For crowdfunding/loan platforms, indicates if the Account is created for a debtor 0 or empty: no 1: yes
    - `payerOrBeneficiary` integer — Indicates if the payment Account is created for a payer or a beneficiary: * Empty: unknown status (default) * 1 = Payer * 2 = Beneficiary
  - `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.net/lemonway/apis/account-onboarding-management-api.md) · [All operations](https://skmtc.net/lemonway/apis/account-onboarding-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lemonway/account-onboarding-management-api/versions/73309fe68e2d/schema)