---
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`

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
- `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.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/revisions/73309fe68e2d/schema)