We've written a quick step-by-step guide to walk you through how to create a Kairos Developer account, make your first API call, and interpret the results.
Step 1: Register for an account
If you are an existing Kairos user, . If not, , to sign-up for Kairos - it's free to test.
Step 2: Get your APP ID and API Key
Once you’ve registered, and confirmed your email, you’ll be able to access your Dashboard. Here you’ll find your ‘App ID’ and ‘(API) Key’. Make a note of these credentials, you will use them in the next step.
Oh, and we automatically created your first app, to save you some time. You can rename this anytime.
This is a good example:
Step 1: Generate an API token
To start your integration, you will need an API token. To generate API tokens:
Access the Kairos Dashboard:
Navigate to the 'Applications' section.
Application Registration:
Provide the necessary details for your application, including the name and description.
Token Retrieval:
Upon successful registration, copy the AppID and APPkey generated for your application.
Step 2: Create a verification request
Create a verification request by making a call to the Karios API. At a minimum, you will need to provide your_app_id, your_app_key, and file paths with your actual application ID, application key, and the paths to your identification document and selfie image, respectively.
This request can be made using any programming language that supports HTTPS requests.
Sample Code
var request = require('request');
var fs = require('fs');
var options = {
'method': 'POST',
'url': 'https://idv-eu.kairos.com/v0.1/full-id-verification',
'headers': {
'app_id': 'put_app_id_here',
'app_key': 'put_app_key_here'
},
formData: {
'selfie': fs.createReadStream('/path/to/selfie_image'),
'document': fs.createReadStream('/path/to/document_image'),
'document_back': fs.createReadStream('/path/to/document_back_image'),
}
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
#!/bin/bash
# Base URL
base_url="https://idv-eu.kairos.com/v0.1/full-id-verification/"
# Specify the api_req_uuid directly
api_req_uuid="put_uuid_from_first_api_response"
# Constructing the full URL with the provided api_req_uuid
url="$base_url$api_req_uuid"
# Making the curl request
curl --location "$url" \
--header 'app_id: put_app_id_here' \
--header 'app_key: put_app_key_here'
It may take some time to receive the verification results. It's recommended to try after 10 seconds from the previous step and repeat if necessary.
A successful response in the verification process includes an overall result for the verification check and detailed results for each individual report. The overall verification check result is derived from these individual report outcomes.
Components of the Response
Document Specifics:
Detailed analysis and results pertaining to the document submitted for verification. This may include information about document authenticity, details extracted from the document, and any anomalies or issues detected.
Selfie Specifics:
Analysis results related to the selfie submitted for verification. This typically involves facial recognition data, liveness detection, and comparison results between the selfie and the document photo, if applicable.
ID Verification:
A comprehensive review of the identification verification process, including key points such as:
Success Indicator: Whether the ID verification was successful.
Transaction ID: A unique identifier for the verification transaction.
Warnings: List of any warnings or alerts generated during the verification process. These can include issues like unrecognized documents, multiple faces detected, liveness verification errors, and discrepancies between document and selfie images.
Decision: The final decision of the verification process (e.g., approved, rejected).
Scores: Any scoring metrics used to quantify aspects of the verification process, such as confidence scores, risk scores, etc.
Note these are truncated results. For full JSON results try the demo images .
