Get started


This is Clust API official online documentation. We have made it simple for you to generate API tokens that can be used to consume Clust's API.

About Clust Sandbox

Clust provides a full testing environment called Clust Sandbox.
The Clust sandbox mirrors the features found on the Clust production servers. While some Clust features may not not apply to the sandbox, this environment has parity with the Clust API feature set supported by the live environment.
This means you can test your Clust processes and know they will behave the same on the production servers as they do in the sandbox environment. To test your code end-to-end, you need to create an account on By using fictitious sandbox test accounts and their associated authentication credentials in your Clust calls, you can test and debug your application without referencing any real Clust users . The sandbox lets you operate your application in a safe environment and provides you a way to fine tune your Clust routines before moving your product into production.

Testing and going live

3 steps to start testing Clust API
1- Create a Clust account on 2- Create and copy your API token in you settings page 3- Add that API token in your API calls to Clust endpoint.
When you're ready to go live, just log in to you Clust account and repeat these steps to get your LIVE API token.
Your users can now enjoy using Clust to collect documents ;)

Create and send a Clust Application (called Dossier in this API)

Using Clust to collect documents can be performed in 5 simple steps
1- Create a Clust Dossier using the Dossier endoint (POST) 2- Get the Dossier public_url attribute from the response 3- Share that url with the Dossier recipient. 4- The recipient uploads the required documents on the Dossier public page. 5- Use the Dossier API (GET) to get the dossier status and uploaded files.

What can a Clust Dossier contain ?
A Clust Dossier can contain dossier items and attachments

Dossier items
: list of documents that need to be provided

There are 5 types of Dossier items :

- file :
This type of Dossier item can accept multiple files. For instance, you can add 1 Dossier item called "Identity card". On the Dossier public page, the recipient will be able to add two different files to this single item (front-side.pdf and back-side.jpg).

- form :
Some times, you may need to gather information from the recipient through an online form. To achieve this, add a Dossier Item with the parameter type=form and add a json form description in the form_data field.
On the Dossier public page, instead of an upload field, an online form will be displayed and filled in by the recipient.

- task :
Useful if you want the user to perform a specifc task.

- payment :
The user will pay a specific amount using his/her credit card.

- eSignature :
The client will be redirect to an eSignature document that he/she will sign directly on the website.

- separator :
Use this value to add a separator in the list. Ex: Personal details, Financial situation, etc.

: external files linked to the dossier

Marketing documentation, user guide, etc. These documents will be displayed in the "Information" section of the public page.

Notification Emails

By default, Clust will send a notification email to the recipient of the Dossier. If you don't want Clust to send that automatic email, add a auto_emails = 0 parameter when you create a Dossier. You will then be in charge of sending the public_url link the recipient

Recipient / Contact

Each Clust Dossier is created for a specific recipient. As part of the new Dossier API (POST), you need to provide the recipient's personal information : first name, last name and email.

Dossier status

After the request has been sent to the recipient, you can call the Dossier endpoint (GET) to check the Dossier' status. Here are the available values :
0_not_started : initial state, no document provided 1_in_progress : documents' collection in progress 2_ocr_validation : documents are being analysed by our OCR engine (if applicatble) 3_submitted : application successfully submitted 4_pre_approved : application successfully pre approved by an operator (if applicable) 5_closed : dossier has been closed

Deadlines and Reminders

When creating a Dossier, you can pass a deadline parameter which will be used by Clust to send 3 reminders to the recipient. (D-7, D-3, D-1). By default, if no deadline is provided, we will add 14 days to the current date to define the deadline. If you don't want these automatic reminders to be sent, you should pass auto_emails = 0.

Embed your list in a web page

Sometime you may want to embed the list of required document directly in a web page for a full white label experience.
This can be achieved by adding ?embedded=1 to the public_url returned when creating an application. Then, pass that URL in an iframe on the target page.