What is the Caisson Identity Verification API?

The Caisson Identity Verification API is a RESTful API that accepts images of identification documents and returns the information from the document as structured, machine readable JSON. Additionally, it is capable of verifying that the information on the document is legitimate.

The Caisson Identity Verification API is a RESTful API that accepts .jpg or .png images of identification documents and verifies and returns the information on the document back as structured JSON.

What do I need to get started?

All you need to get started is a valid API key, which you get immediately upon registration.

Which documents does the API accept?

Caisson can currently process any valid, US driver’s license.

Why does Caisson ask for three pieces of information for each API request?

You should submit three images with each API request: the front of the document, the back of the document, and a ‘selfie’ of the person who is presenting the document to you. These three pieces of information work together to confidently verify the purported identity.

While you can use the API to simply extract information from the front of an identification document and put it in a machine-readable format, neither Caisson nor any other software can confidently verify an identity without the other two images.

What’s the minimum amount of information I need to use the API?

You can use the Identity Verification API to extract data from just an image of the front of a valid US driver’s license. However, if you’re only able to submit an image of the front of the document, the API can only perform the minimum level of verification — checking that the format of the document matches the standard design — and return the machine-readable JSON file.

How much does it cost to verify a single document?

It’s free to get started! Your first 1,000 API calls — one for each verified document — are free each month. Once you hit 1,000 requests in a single month, you’ll pay just $0.50 per request.

We’ll never charge for a request if we have a problem processing a document, even if the issue is due to a low-quality image that cannot be read.

There are no additional charges for complete identity verification; a single API request constitutes all three requested images.

Do I need a credit card to get started?

In order to validate your account, you must submit an active credit card when you sign up. We will not charge it until after you make 1,000 API calls, and if for any reason your card is invalidated after registration, you’ll still be able to use your monthly free requests.

What’s the billing frequency?

We’ll charge the card on file on the 1st of each month, for your usage in the prior month.

Remember, your first 1,000 requests are always free, and each request after that is $0.50. So, if you make 2,000 API calls in April, we’ll charge you $500 on May 1st.

What are the recommended image specifications?

The API needs high resolution, in-focus images to ensure accurate processing. At a minimum, we recommend images at 1024x768 resolution, but the API will accept images of any size up to 10 MB.

Is Caisson safe and secure? What happens to the data after I upload it?

We take security seriously, and built the platform from the ground up with privacy and security in mind. All of the data that you submit, and that we process, is encrypted in transit and at rest. While we rely on a handful of third-party services, we thoroughly vet them for a commitment to privacy and security, and only share with these services in the course of operating our service. Data submitted to the Caisson API will never, ever be shared for advertising or other non-functional purposes.

We only share the documents you upload with third parties in the course of providing you service. Read our Privacy Policy for more information, or feel free to contact us with specific questions.

Does Caisson have a plug-in for JavaScript, iOS, Android, etc. to capture images directly from my users?

Not at this time.

Is the Caisson SDK available in other languages?

Not at this time.

What if I have another question?

Email us! We’d love to hear from you and help any way we can.