---
title: Document Uploads
description: Document Uploads
---

[Skip to content](https://support.icomplyis.com/document-uploads#main-content)

English

Show submenu for translations

[More support](https://support.icomplyis.com/kb-tickets/new?hsLang=en) [Sign in](https://support.icomplyis.com/_hcms/mem/login?redirect_url=https%3A%2F%2Fsupport.icomplyis.com%2Fdocument-uploads&hsLang=en)

![iComply Logo Square.jpg\]](https://support.icomplyis.com/hs-fs/hubfs/iComply%20Logo%20Square.jpg?height=40&name=iComply%20Logo%20Square.jpg)

Open main navigation

Close main navigation

- English
  
  Show submenu for translations
- [More support](https://support.icomplyis.com/kb-tickets/new)
- [Sign in](https://support.icomplyis.com/_hcms/mem/login?redirect_url=https%3A%2F%2Fsupport.icomplyis.com%2Fdocument-uploads)
- [Platform Login](https://kyc.icomplykyc.com/auth/login)

[Platform Login](https://kyc.icomplykyc.com/auth/login)

 Hello. How can we help you?

- There are no suggestions because the search field is empty.

1. [iComply Knowledge Base](https://support.icomplyis.com/?hsLang=en)
2. [iComply API Documentation](https://support.icomplyis.com/icomply-api-documentation?hsLang=en)
3. [API Reference](https://support.icomplyis.com/icomply-api-documentation?hsLang=en#api-reference)

- [Quick Start Guide](https://support.icomplyis.com/quick-start-guide?hsLang=en#main-content)
  
  
  
  
  
    - [Admin User Setup Guide](https://support.icomplyis.com/quick-start-guide?hsLang=en#admin-user-setup-guide)
    - [Portal Setup Guide](https://support.icomplyis.com/quick-start-guide?hsLang=en#portal-setup-guide)
    - [Platform User Guide](https://support.icomplyis.com/quick-start-guide?hsLang=en#platform-user-guide)
- [Product Documentation](https://support.icomplyis.com/product-documentation?hsLang=en#main-content)
  
  
  
  
  
    - [General](https://support.icomplyis.com/product-documentation?hsLang=en#general)
    - [Platform Overview](https://support.icomplyis.com/product-documentation?hsLang=en#platform-overview)
    - [KYC Module](https://support.icomplyis.com/product-documentation?hsLang=en#kyc-module)
    - [KYB Module](https://support.icomplyis.com/product-documentation?hsLang=en#kyb-module)
    - [AML Module](https://support.icomplyis.com/product-documentation?hsLang=en#aml-module)
    - [Administration](https://support.icomplyis.com/product-documentation?hsLang=en#administration)
    - [Portals](https://support.icomplyis.com/product-documentation?hsLang=en#portals)
    - [Troubleshoot](https://support.icomplyis.com/product-documentation?hsLang=en#troubleshoot)
    - [FAQ](https://support.icomplyis.com/product-documentation?hsLang=en#faq)
    - [Compliance](https://support.icomplyis.com/product-documentation?hsLang=en#compliance)
    - [Release Notes](https://support.icomplyis.com/product-documentation?hsLang=en#release-notes)
- [iComply API Documentation](https://support.icomplyis.com/icomply-api-documentation?hsLang=en#main-content)
  
  
  
  
  
    - [API Reference](https://support.icomplyis.com/icomply-api-documentation?hsLang=en#api-reference)
- [FAQs](https://support.icomplyis.com/faqs?hsLang=en#main-content)
  
  
  
  
  
    - [Product](https://support.icomplyis.com/faqs?hsLang=en#product)

# Document Uploads

First upload one by one image to this endpoint: [https://api.icomplykyc.com/api/v2/entities/natural-persons/images](https://api.icomplykyc.com/api/v2/entities/natural-persons/images)

If the document is a passport, upload one image with a single call to this endpoint. If it’s a driver’s license or an ID card, upload both the front and back images with two separate calls to this endpoint. The image is sent through Form data.

In the response for each call to this endpoint, you will receive a `filename` for the uploaded image, which you will use in the next request:[https://api.icomplykyc.com/api/v2/entities/natural-persons/{id}/identity-documents](https://api.icomplykyc.com/api/v2/entities/natural-persons/%7Bid%7D/identity-documents)

For the body of this request, send:  
{  
    documentFrontFileName  
    documentBackFileName  
    documentType  
    status  
}

All fields are of type string:

- `documentFrontFileName` always has a value, which is the filename of the passport image, or the front side of the ID card or driver’s license, obtained from the first endpoint.
- `documentBackFileName` has a value only if the document is an ID card or a driver’s license. This value is obtained from the second call to the first endpoint.
- `documentType` can be one of the following values: `"passport"`, `"driversLicense"`, or `"idCard"`.
- `status` is the status in which the ID event should be set, and can be `"Review"`, `"Accepted"`, or `"Rejected"`.

Here is an example request when the document is a passport:  
First call [https://api.icomplykyc.com/api/v2/entities/natural-persons/images](https://api.icomplykyc.com/api/v2/entities/natural-persons/images) and send passport in form data and response will be 88563d51-d1c5-47b7-b357-821279cbdb3a.jpg  
Then call [https://api.icomplykyc.com/api/v2/entities/natural-persons/123456/identity-documents](https://api.icomplykyc.com/api/v2/entities/natural-persons/123456/identity-documents) and send in body:

{  
    "documentFrontFileName": "88563d51-d1c5-47b7-b357-821279cbdb3a.jpg",  
    "documentType": "passport",  
    "status": "Review"  
}

Finally, call [https://api.icomplykyc.com/api/v2/entities/natural-persons/123456/images](https://api.icomplykyc.com/api/v2/entities/natural-persons/123456/images) to get images for entity with id 123456 

# iComply Investor Services Inc - icomplyis.com

icomplyis.com Help Center

Copyright © 2025, iComply Investor Services Inc - icomplyis.com