---
title: "List KYC Documents for a User"
method: GET
path: "/v2.01/{ClientId}/users/{UserId}/kyc/documents"
tags: ["kycDocuments"]
---

# List KYC Documents for a User

`GET /v2.01/{ClientId}/users/{UserId}/kyc/documents`

<Warning icon="fa-regular fa-triangle-exclamation">
**Caution – Legacy endpoints being superseded by the hosted KYC/KYB solution**

Mangopay's [hosted KYC/KYB solution](/guides/users/verification/hosted) is becoming mandatory for all platforms (relying on the [IDV Session](/api-reference/idv-sessions/idv-session-object) object). The legacy KYC Document endpoints remain available for the sole purposes of [sending additional documents](/guides/users/verification/hosted#sending-additional-documents), but this use case will also be handled by the hosted solution in future.
</Warning>

## Path parameters

- `ClientId` string, required
- `UserId` string, required

## Query parameters

- `Status` string
- `Type` string
- `BeforeDate` integer
- `AfterDate` integer

## Headers

- `Authorization` string, required

## Response `200`

Success

- ListAllKYCDocumentsResponse
  - `Array (KYCDocument)` ListAllKycDocumentsResponseArrayKycDocumentItems[] — The list of KYC documents created by the platform.
    - `Object (KYCDocument)` ListAllKycDocumentsResponseArrayKycDocumentItemsObjectKycDocument — KYC Document created by the platform.
      - `Type` string — **Returned values:** `IDENTITY_PROOF`, `REGISTRATION_PROOF`, `ARTICLES_OF_ASSOCIATION`, `SHAREHOLDER_DECLARATION`, `ADDRESS_PROOF` The type of the document for the user verification.
      - `UserId` string — The unique identifier of the user.
      - `Flags` string[] — **Returned values:** A code from the <a href="/guides/users/verification/documents/submission/refusals" target="_blank">Flags list</a>. The series of codes providing more precision regarding the reason why the identity proof document was refused. You can review the explanations for each code in the <a href="/guides/users/verification/documents/submission/refusals" target="_blank">Flags list</a>.
      - `Id` string — Max length: 128 characters (see [data formats](/api-reference/overview/data-formats) for details) The unique identifier of the object.
      - `Tag` string — Custom data that you can add to this object. For transactions (pay-in, transfer, payout), you can use this parameter to identify corresponding information regarding the user, transaction, or payment methods on your platform.
      - `Status` string — **Returned values:** `CREATED`, `VALIDATION_ASKED`, `VALIDATED`, `REFUSED`, `OUT_OF_DATE` The status of the document: - `CREATED` – The document container is created and files can be uploaded using the [POST Create a KYC Document Page](/api-reference/kyc-documents/create-kyc-document-page) endpoint before submission. - `VALIDATION_ASKED` – The document is submitted to Mangopay for validation. - `VALIDATED` – The document is validated by Mangopay's teams. - `REFUSED` – The document is rejected by Mangopay's teams and a new KYC Document object needs to be created to resubmit it. You can learn more about the reason why it was refused in the `RefusedReasonType` parameter. - `OUT_OF_DATE` – The document is downgraded and a new KYC Document object needs to be created to resubmit it.
      - `RefusedReasonType` string — **Returned values:** DOCUMENT_DO_NOT_MATCH_USER_DATA, DOCUMENT_FALSIFIED, DOCUMENT_HAS_EXPIRED, DOCUMENT_INCOMPLETE, DOCUMENT_MISSING, DOCUMENT_NOT_ACCEPTED, DOCUMENT_UNREADABLE, SPECIFIC_CASE, UNDERAGE_PERSON Returned `null` unless `Status` is `REFUSED`. The reason for the document refusal. See the <a href="/guides/users/verification/documents/submission/refusals">refused reason types</a> for more information depending on the document type.
      - `RefusedReasonMessage` string — **Default value:** null Additional information about why the KYC Document was refused, provided by Mangopay's team.

---

[API](https://skmtc.dev/mangopay/apis/api-reference.md) · [All operations](https://skmtc.dev/mangopay/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/mangopay/api-reference/revisions/fafbd0c69654/schema)