REST API

Rest API for Backend or custom integrations

Use this documentation to verify your users, detect liveness, and integrate into your UI/UX via a REST API. Although we recommend using the SDKs, we know that some systems may be better suited for the REST API, so we got you covered.

How to use the Rest API

1) Onboarding new customers

Andia stores the Biometrics Vectors from a video selfie (dynamic validation) or a picture selfie (static validation) that is taken during on-boarding process. This method returns a unique user identifier (user_id), with which one-to-one validations will be carried out later.

2) Dynamic Validations (Liveness Detection)

Verify a user is alive by validating that the user has blinked on video against the existing user_id.

4) Static Validations (no Liveness Detection)

Verify if a Selfie taken corresponds to an existing user_id (A user who has previously been onboarded).

Dynamic Validations (Liveness validation) endpoints

post
Register new customer

https://api.andia.io/v1/register_new_customer_video
This endpoint generates the Biometric vectors from new users using a short selfie video (1 to 3 seconds long) and returns a unique user_id.
Request
Response
Request
Headers
Content-Type
required
string
application/json
Authentication
required
string
Your API_KEY
Form Data Parameters
video64
optional
string
Base64 string (converted from mp4 format to Base64) ***The video must include a user blink.
video
optional
object
Selfie video file (mp4 format) Recommended size less than 2 Mb Important ***The video must include a user blink.
Response
200: OK
{
"success": true,
"error_code": 0,
"error": "",
"message": "success",
"user_id": "fb61986b-8208-4b9b-b4d5-49eb1178cdcd"
}

post
Validation

https://api.andia.io/v1/validate_transaction_video
This endpoint compare an existing user_id against a short selfie video (1 to 3 seconds long).
Request
Response
Request
Headers
Content-Type
required
string
application/json
Authentication
required
string
Your API_KEY
Form Data Parameters
video64
optional
string
Base64 string (converted from mp4 format to Base64) ***The video must include a user blink
user_id
required
string
An existing user identifier
video
optional
object
Selfie video file (mp4 format) Recommended size less than 2 Mb. Important ***The video must include a user blink.
Response
200: OK
{
"success": true,
"error_code": 0,
"error": "",
"message": "It is a Match"
}

Static methods (No Liveness detection) in case of existing user images

post
Register new customer

https://api.andia.io/v1/register_new_customer
This endpoint stores the Biometric vectors from new users and generate a unique user_id.
Request
Response
Request
Headers
Content-Type
required
string
application/json
Authentication
required
string
Your API_KEY
Form Data Parameters
selfie
optional
object
Selfie image file (jpg format) Recommended size less than 512 Kb
Body Parameters
selfie64
optional
string
Base 64 jpg Image (Required if selfie file is not provided) Recommended size less than 512 Kb
Response
200: OK
{
"success": true,
"error_code": 0,
"error": "",
"message": "success",
"user_id": "fb61986b-8208-4b9b-b4d5-49eb1178cdcd"
}

post
Validation

https://api.andia.io/v1/validate_transaction
This endpoint compare an existing user_id against a Selfie.
Request
Response
Request
Headers
Content-Type
required
string
application/json
Authentication
required
string
Your API_KEY
Form Data Parameters
selfie64
optional
string
Base 64 JPG Image Required if selfie file is not provided Recommended size less than 512 Kb
user_id
required
string
An existing user identifier
selfie
optional
object
Selfie image file (jpg format) Recommended size less than 512 Kb
Response
200: OK
Cake successfully retrieved.
{
"success": true,
"error_code": 0,
"error": "",
"message": "It is a Match"
}