Ask or search…
K

Quick Start

Making your first API call
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, log in to your dashboard. If not, 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:
  1. 1.
    Access the Kairos Dashboard:
    • Navigate to the 'Applications' section.
  2. 2.
    Application Registration:
    • Provide the necessary details for your application, including the name and description.
  3. 3.
    Token Retrieval:
    • Upon successful registration, copy the AppID and APPkey generated for your application.
Applications List

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 Command (Using Bash)
export APP_ID=your_app_id
export APP_KEY=your_app_key
curl -v -X POST https://dev-api.kairos.com/api-v4/full-id-verification \
-H "app_id: $APP_ID" -H "app_key: $APP_KEY" \
-F document=@/path_to/id_doc.jpg \
-F selfie=@/path_to/face.png
The command returns a response containing the 'api_req_uuid', which is used in the next step to retrieve verification results.

Step 3: Retrieving verification results

Use the 'api_req_uuid' obtained from the previous step to request verification results.
This request can be made using any programming language that supports HTTP requests.
Sample Command (Using Bash)
export UID=your_api_req_uuid
curl "https://dev-api.kairos.com/api-v4/full-id-verification/$UID" \
-H "app_id: $APP_ID" -H "app_key: $APP_KEY"
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.

Sample Images

Sample ID Document (Falsified)
Sample Selfie

Sample Results

Note these are truncated results. For full JSON results try the demo images here.
{
"requested_at": "2024-01-30 09:14:34",
"processed_at": "2024-01-30 09:14:40",
"response_code": 0,
"response_data": {
"document": {
"data": {
"address1": [
{
"value": "SACRE COEUR, PARIS,",
"confidence": 0.8,
"source": "visual",
"index": 0,
"input_box": [
...
]
}
],
...
"vehicle_class": [
{
"value": "B, AM",
"confidence": 0.813,
"source": "visual",
"index": 0,
"input_box": [
...
]
}
]
}
},
"decision": {
"review_score": 0,
"reject_score": 0,
"details": []
},
"biometric": {
"selfie": {
"img_width": 347,
"img_height": 463,
"faces_predicted": [
...
],
"faces_liveness": 0.9981
},
"document": {
"img_width": 756,
"img_height": 1008,
"faces_predicted": [
...
]
},
"face_match_confidence": 0.5487
}
}
}

Results breakdown

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
  1. 1.
    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.
  2. 2.
    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.
  3. 3.
    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.