---
title: "Get Detailed Payment Account Data"
method: GET
path: "/v2/accounts/{accountid}"
tags: ["Accounts | Admin"]
---

# Get Detailed Payment Account Data

`GET /v2/accounts/{accountid}`

## 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}`
- Auth: none declared. Required headers: `Authorization`, `PSU-IP-Address`

Enables your system to get detailed payment account information including:   
* Payment account balance   
* Account type    
* Account status (if blocked or not) 
* Account email address

## Path parameters

- `accountid` string, required

## Headers

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

## Response `200`

OK

- AccountDetailsOutput
  - `account` 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, required: Company name (at least one alphabethic character is required)
      - `description` string, required: 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, required: Client country using ISO 3166-1 alpha-3
    - `birth` Birth
      - `date` string, required: 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.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)