--- title: "Get documents" method: POST path: "/getUploadedDocuments" tags: ["Verification"] --- # Get documents `POST /getUploadedDocuments` Returns documents that were previously uploaded for an account holder. Adyen uses the documents during the [verification process](https://docs.adyen.com/classic-platforms/verification-process). ## Request body - GetUploadedDocumentsRequest - `accountHolderCode` string, required — The code of the Account Holder for which to retrieve the documents. - `bankAccountUUID` string — The code of the Bank Account for which to retrieve the documents. - `shareholderCode` string — The code of the Shareholder for which to retrieve the documents. ## Response `200` OK - the request has succeeded. - GetUploadedDocumentsResponse - `documentDetails` DocumentDetailWrapper[] — A list of the documents and their details. - `DocumentDetail` DocumentDetail - `accountHolderCode` string — The code of account holder, to which the document applies. - `bankAccountUUID` string — The Adyen-generated [`bankAccountUUID`](https://docs.adyen.com/api-explorer/#/Account/latest/post/createAccountHolder__resParam_accountHolderDetails-bankAccountDetails-bankAccountUUID) to which the document must be linked. Refer to [Bank account check](https://docs.adyen.com/classic-platforms/verification-checks/bank-account-check#uploading-a-bank-statement) for details on when a document should be submitted. >Required if the `documentType` is **BANK_STATEMENT**, where a document is being submitted in order to verify a bank account. - `description` string — Description of the document. - `documentType` 'BANK_STATEMENT' | 'BSN' | 'DRIVING_LICENCE' | 'DRIVING_LICENCE_BACK' | 'DRIVING_LICENCE_FRONT' | 'ID_CARD' | 'ID_CARD_BACK' | 'ID_CARD_FRONT' | 'PASSPORT' | 'PROOF_OF_RESIDENCY' | 'SSN', required — The type of the document. Refer to [Verification checks](https://docs.adyen.com/classic-platforms/verification-checks) for details on when each document type should be submitted and for the accepted file formats. Permitted values: * **BANK_STATEMENT**: A file containing a bank statement or other document proving ownership of a specific bank account. * **COMPANY_REGISTRATION_SCREENING** (Supported from v5 and later): A file containing a company registration document. * **CONSTITUTIONAL_DOCUMENT**: A file containing information about the account holder's legal arrangement. * **PASSPORT**: A file containing the identity page(s) of a passport. * **ID_CARD_FRONT**: A file containing only the front of the ID card. In order for a document to be usable, both the **ID_CARD_FRONT** and **ID_CARD_BACK** must be submitted. * **ID_CARD_BACK**: A file containing only the back of the ID card. In order for a document to be usable, both the **ID_CARD_FRONT** and **ID_CARD_BACK** must be submitted. * **DRIVING_LICENCE_FRONT**: A file containing only the front of the driving licence. In order for a document to be usable, both the **DRIVING_LICENCE_FRONT** and **DRIVING_LICENCE_BACK** must be submitted. * **DRIVING_LICENCE_BACK**: A file containing only the back of the driving licence. In order for a document to be usable, both the **DRIVING_LICENCE_FRONT** and **DRIVING_LICENCE_FRONT** must be submitted. - `filename` string — Filename of the document. - `shareholderCode` string — The Adyen-generated [`shareholderCode`](https://docs.adyen.com/api-explorer/#/Account/latest/post/createAccountHolder__resParam_accountHolderDetails-businessDetails-shareholders-shareholderCode) to which the document must be linked. Refer to [Verification checks](https://docs.adyen.com/classic-platforms/verification-checks) for details on when a document should be submitted. >Required if the account holder has a `legalEntity` of type **Business** and the `documentType` is either **PASSPORT**, **ID_CARD_FRONT**, **ID_CARD_BACK**, **DRIVING_LICENCE_FRONT**, or **DRIVING_LICENCE_BACK**. - `signatoryCode` string — The Adyen-generated [`signatoryCode`](https://docs.adyen.com/api-explorer/#/Account/v6/post/createAccountHolder__resParam_accountHolderDetails-businessDetails-signatories-signatoryCode) to which the document must be linked. - `pspReference` string — The reference of a request. Can be used to uniquely identify the request. - `resultCode` string — The result code. - `submittedAsync` boolean — Indicates whether the request is processed asynchronously. Depending on the request's platform settings, the following scenarios may be applied: * **true**: The request is queued and will be executed when the providing service is available in the order in which the requests are received. * **false**: The processing of the request is immediately attempted; it may result in an error if the providing service is unavailable. ## Other responses - `400` — Bad Request - a problem reading or understanding the request. - `401` — Unauthorized - authentication required. - `403` — Forbidden - insufficient permissions to process the request. - `422` — Unprocessable Entity - a request validation error. - `500` — Internal Server Error - the server could not process the request. ## Changes - **2023-04-12** (v3) `9371f31bd06c` — 2 breaking, 6 warning, 1 info - the `documentDetails/items/` response's property type/format changed from `object`/`` to ``/`` for status `200` - removed the required property `documentDetails/items/documentType` from the response with the `200` status - removed the optional property `documentDetails/items/accountHolderCode` from the response with the `200` status - removed the optional property `documentDetails/items/bankAccountUUID` from the response with the `200` status - …5 more - **2023-03-22** (v3) `a6068822877c` — 10 breaking - the request's body type/format changed from ``/`` to `object`/`` - the response's body type/format changed from ``/`` to `object`/`` for status `200` - the response's body type/format changed from ``/`` to `object`/`` for status `400` - the response's body type/format changed from ``/`` to `object`/`` for status `401` - …6 more - **2022-02-15** (v3) `77d88677157d` — 1 warning - added the new `PROOF_OF_RESIDENCY` enum value to the `documentDetails/items/documentType` response property for the response status `200` - …earlier changes not shown [Full history](https://skmtc.dev/adyen/apis/accountservice/changes/getUploadedDocuments/post.md) --- [API](https://skmtc.dev/adyen/apis/accountservice.md) · [All operations](https://skmtc.dev/adyen/apis/accountservice/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/adyen/accountservice/revisions/5896dea74c98/schema)