---
title: "Find a user, document or an IBAN that has been modified since an entry date"
method: GET
path: "/v2/accounts/kycstatus"
tags: ["Accounts | Create & KYC"]
---

# Find a user, document or an IBAN that has been modified since an entry date

`GET /v2/accounts/kycstatus`

## Request

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

Use to find users, documents, IBAN for which the status has changed since a specified date.  
**Note:** Returns the same user multiple times in the same request if his status has changed multiple time since a specified date.

## Query parameters

- `updateDate` string, required
- `page` integer
- `limit` integer

## Headers

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

## Response `200`

OK

- KycStatusOutput
  - `accounts` AccountKycStatus[]
    - `id` string: Payment account ID
    - `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/>
    - `date` string: Modification date of the payment account status in Second UTC
    - `documents` Document[]
      - `id` integer: Document ID
      - `status` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8: Document Status<br/>0 = Document put on hold, waiting for another document.<br/>1 = Received, need manual validation.<br/>2 = Accepted.<br/>3 = Rejected.<br/>4 = Rejected. Unreadable by human (Cropped, blur, glare…).<br/>5 = Rejected. Expired (Expiration Date is passed).<br/>6 = Rejected. Wrong Type (Document not accepted).<br/>7 = Rejected. Wrong Name (Name not matching user information).<br/>8 = Rejected. Duplicated Document.<br/>
      - `type` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21: Document Type<br/>0 = ID card (both sides in one file).<br/>1 = Proof of address.<br/>2 = Scan of a proof of IBAN.<br/>3 = Passport (European Union).<br/>4 = Passport (outside the European Union).<br/>5 = Residence permit (both sides in one file).<br/>6 = Other document type.<br/>7 = Official company registration document (Kbis extract or equivalent).<br/>11 = Driver licence (both sides in one file).<br/>12 = Status.<br/>13 = Selfie.<br/>14 = Other document type.<br/>15 = Other document type.<br/>16 = Other document type.<br/>17 = Other document type.<br/>18 = Other document type.<br/>19 = Other document type.<br/>20 = Other document type.<br/>21 = SDD mandate.<br/>
      - `validityDate` string: Document validity date Format: dd/mm/yyyy Empty if unknown
      - `comment` string
    - `ibans` Iban[]
      - `id` integer: IBAN ID
      - `status` 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9: Only status 5 allows the use of the IBAN for a Money-Out.<br/>1 = None.<br/>2 = Internal.<br/>3 = Not used.<br/>4 = Waiting to be verified by Lemon Way.<br/>5 = Activated.<br/>6 = Rejected by the bank.<br/>7 = Rejected, no owner.<br/>8 = Deactivated.<br/>9 = Rejected.<br/>
      - `iban` string: IBAN saved
      - `swift` string: SWIFT BIC code associated with the IBAN
      - `holder` string: IBAN Holder
      - `type` integer: Indicates if a merchant IBAN or a virtual client IBAN 1: Merchant IBAN 2: IBAN virtual client
    - `sddMandates` SddMandate[]
      - `id` integer: Mandate ID
      - `status` 0 | 5 | 6 | 8 | 9: Mandate Status<br/>0 = Pending validation.<br/>5 = Validated, First SDD to be done.<br/>6 = Enabled.<br/>8 = Disabled.<br/>9 = Rejected.<br/>
      - `IBAN` string: IBAN associated to the mandate
      - `BIC` string: SWIFT code associated to the mandate
      - `holder` string: IBAN Holder
      - `UniqueMandateReference` string: Unique mandate reference
  - `_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)