API DOCUMENTATION

Welcome to the official API documentation

Designed to serve as the definitive technical blueprint for developers seeking to integrate our robust services into your ecosystems. This comprehensive resource provides an exhaustive breakdown of our architectural framework, ensuring that every interaction with our platform is secure.

Within these pages, you will find accurate detail regarding our RESTful endpoints, industry-standard authentication protocols, and the nuances of our multifaceted data structures. Our primary objective is to offer a transparent and highly structured roadmap that facilitates a friction-less onboarding experience for your ecosystems.

By covering every critical phase—from the initial connection setup to sophisticated error diagnostic strategies—we aim to minimize development overhead. Ultimately, this documentation is crafted to empower you with the insights necessary to achieve a seamless, scalable, and resilient integration process.

Getting Started with Our API

To ensure a secure and seamless integration for all our developers, access to this API is currently managed via a manual registration process. To request your credentials, please send a formal registration inquiry to our support team at support@divasinergi.com.

Once your request has been submitted, our team will review your application and finalize your account setup. In the meantime, we encourage you to proceed to the Authentication section. There, you will find comprehensive documentation on how to generate the necessary authorization headers and secure your connection to our services.

Authentication

To interact with our protected endpoints, you must include a valid JSON Web Token (JWT) in your request headers. This token is obtained after a successful login and serves as your digital identity for all subsequent API calls.

The Authentication Process

Once you have completed the registration and received your credentials, you can perform a POST request to our login endpoint. Upon a successful login, the server will return a JSON response containing a unique token.

{
	"success": true,
	"statusCode": 200,
	"message": "Login Success.",
	"data": {
		"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.e-ri73ScUYQaO8RiIJvLE",
		"member": {
			"id": 1,
			"code": "1881-E62B-7341-A",
			"name": "user",
			"email": "user@email.com",
			"member": 1,
			"status": "active"
		}
	},
	"rows": 2,
	"apiCost": {
		"start": "2026-03-31 15:56:56'255",
		"finish": "2026-03-31 15:56:56'333",
		"duration": 0.078
	}
}

How to Use the Token

To authenticate your requests, you must pass the token string (found in data.token) into the Authorization header using the Bearer Authentication scheme.

Key     : Authorization
Value   : Bearer <your_token_here>

Important Notes:

Token Security: Please treat your token like a password. Never share it publicly or include it in client-side code that is visible to everyone.
Expiration: Each token has a specific lifespan. If you receive a 401 Unauthorized response, it may indicate that your token has expired and you will need to log in again to receive a fresh one.

API Reference

Once you have successfully authenticated your requests using the Bearer Token, you can begin interacting with our available resources. Below is a comprehensive list of the endpoints provided by this API.

POST /sanbox/gettoken

Request Body :

Name	Type	Description
id*	int	Client ID for Enrollment BIOID

Request Example :

curl --location 'https://faceverify-api.divasinergi.com/sanbox/gettoken' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data '{
    "id": "1"
}'

Response Example :

{
    "success": true,
    "statusCode": 200,
    "message": "eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.ey8WlOg2NImldszobeywFQ8t_O8qjyuvzp6s7A",
    "data": {},
    "rows": 0,
    "apiCost": {
        "start": "2026-03-31 16:20:14'100",
        "finish": "2026-03-31 16:20:14'105",
        "duration": 0.005
    }
}

POST /sanbox/enrollment/mobile

Request Body :

Name	Type	Description
id*	int	Client ID for Enrollment Virtual BIOID
image01*	string	base64 Image ( only accept jpg, png, jpeg \| max filesize 5mb \| max resolution 640 x 480 )
image02*	string	Image 02

Request Example :

curl --location 'https://faceverify-api.divasinergi.com/sanbox/enrollment/mobile' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data '{
    "id": "1",
    "name": "user",
    "image01": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/",
    "image02": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/"
}'

Response Example :

{
    "success": true,
    "statusCode": 200,
    "message": "THANK YOU\nCode : 3B41-B04F-F03D-6C\nName : user\nEnrollment Date : 2026-03-31 164:43:13\nStatus : SUCCESS !",
    "data": {
        "errors": [],
        "status": "SUCCEEDED",
        "enrolled_images": 2,
        "template_status": {
            "tags": [],
            "classId": "72",
            "enrolled": {
                "nanos": 317820700,
                "seconds": "1774950193"
            },
            "available": true,
            "thumbnails": [],
            "encoder_version": 5,
            "feature_vectors": 2,
            "thumbnails_stored": 2
        },
        "image_properties": {
            "0": {
                "faces": [
                    {
                        "left_eye": {
                            "x": 574.4240300679452,
                            "y": 612.9133838019533
                        },
                        "right_eye": {
                            "x": 394.6419671562407,
                            "y": 619.7576682273813
                        },
                        "movement_direction": 0,
                        "motion_liveness_score": 0,
                        "texture_liveness_score": 0
                    }
                ],
                "rotated": 0,
                "frame_number": 0,
                "quality_score": 0,
                "quality_assessments": []
            },
            "1": {
                "faces": [
                    {
                        "left_eye": {
                            "x": 574.4240300679452,
                            "y": 612.9133838019533
                        },
                        "right_eye": {
                            "x": 394.6419671562407,
                            "y": 619.7576682273813
                        },
                        "movement_direction": 0,
                        "motion_liveness_score": 0,
                        "texture_liveness_score": 0
                    }
                ],
                "rotated": 0,
                "frame_number": 1,
                "quality_score": 0,
                "quality_assessments": []
            }
        },
        "performed_action": "NEW_TEMPLATE_CREATED"
    },
    "rows": 6,
    "apiCost": {
        "start": "2026-03-31 16:43:07'379",
        "finish": "2026-03-31 16:43:13'932",
        "duration": 6.553
    }
}

POST /sanbox/enrollment/virtual

Request Body :

Name	Type	Description
id*	int	Client ID for Authentication Liveness BIOID
name*	string	Name
image01*	string	Image 01

Request Example :

curl --location 'https://faceverify-api.divasinergi.com/sanbox/enrollment/virtual' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data '{
    "id": "1",
    "name": "user",
    "image01": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/"
}'

Response Example :

{
    "success": true,
    "statusCode": 200,
    "message": "THANK YOU\nCode : 3B41-BD7B-78F1-A5\nName : user\nEnrollment Date : 2026-03-31 164:44:08\nStatus : SUCCESS !",
    "data": {
        "errors": [],
        "status": "SUCCEEDED",
        "enrolled_images": 1,
        "template_status": {
            "tags": [],
            "classId": "73",
            "enrolled": {
                "nanos": 662647700,
                "seconds": "1774950247"
            },
            "available": true,
            "thumbnails": [],
            "encoder_version": 5,
            "feature_vectors": 1,
            "thumbnails_stored": 1
        },
        "image_properties": {
            "0": {
                "faces": [
                    {
                        "left_eye": {
                            "x": 574.4240300679452,
                            "y": 612.9133838019533
                        },
                        "right_eye": {
                            "x": 394.6419671562407,
                            "y": 619.7576682273813
                        },
                        "movement_direction": 0,
                        "motion_liveness_score": 0,
                        "texture_liveness_score": 0
                    }
                ],
                "rotated": 0,
                "frame_number": 0,
                "quality_score": 0,
                "quality_assessments": []
            }
        },
        "performed_action": "NEW_TEMPLATE_CREATED"
    },
    "rows": 6,
    "apiCost": {
        "start": "2026-03-31 16:44:03'934",
        "finish": "2026-03-31 16:44:08'100",
        "duration": 4.166
    }
}

POST /sanbox/verify/liveness

Request Body :

Name	Type	Description
id*	int	Client ID for Authentication Passive BIOID
image01*	string	Image01
image02*	string	Image 02

Request Example :

curl --location 'https://faceverify-api.divasinergi.com/sanbox/verify/liveness' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data '{
    "id": "1",
    "image01": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/",
    "image02": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/"
}'

Response Example :

{
    "success": true,
    "statusCode": 200,
    "message": "THANK YOU\nCode : 264E-78D4-8BBF-A\nName : user\nAuth Date : 2026-03-31 164:49:31\nStatus : SUCCESS !",
    "data": {
        "score": 0.7424989987096763,
        "errors": [],
        "status": "SUCCEEDED",
        "verified": true,
        "image_properties": {
            "faces": [
                {
                    "left_eye": {
                        "x": 710.2469517570762,
                        "y": 356.2550519154349
                    },
                    "right_eye": {
                        "x": 586.9544283228709,
                        "y": 354.673923038717
                    },
                    "movement_direction": 0,
                    "motion_liveness_score": 0,
                    "texture_liveness_score": 0
                }
            ],
            "rotated": 0,
            "frame_number": 0,
            "quality_score": 0,
            "quality_assessments": []
        }
    },
    "rows": 5,
    "apiCost": {
        "start": "2026-03-31 16:49:26'956",
        "finish": "2026-03-31 16:49:31'750",
        "duration": 4.794
    }
}

POST /sanbox/verify/passive

Request Body :

Name	Type	Description
id*	int	Client ID for Authentication Passive BIOID
image01*	string	Image 01

Request Example :

curl --location 'https://faceverify-api.divasinergi.com/sanbox/verify/passive' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data '{
    "id": "1",
    "image01": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/"
}'

Response Example :

{
    "success": true,
    "statusCode": 200,
    "message": "THANK YOU\nCode : 264E-78D4-8BBF-A\nName : user\nAuth Date : 2026-03-31 164:50:18\nStatus : SUCCESS !",
    "data": {
        "score": 0.7424989987096763,
        "errors": [],
        "status": "SUCCEEDED",
        "verified": true,
        "image_properties": {
            "faces": [
                {
                    "left_eye": {
                        "x": 710.2469517570762,
                        "y": 356.2550519154349
                    },
                    "right_eye": {
                        "x": 586.9544283228709,
                        "y": 354.673923038717
                    },
                    "movement_direction": 0,
                    "motion_liveness_score": 0,
                    "texture_liveness_score": 0
                }
            ],
            "rotated": 0,
            "frame_number": 0,
            "quality_score": 0,
            "quality_assessments": []
        }
    },
    "rows": 5,
    "apiCost": {
        "start": "2026-03-31 16:50:16'200",
        "finish": "2026-03-31 16:50:18'653",
        "duration": 2.453
    }
}

POST /sanbox/verify/liveness

Request Body :

Name	Type	Description
id*	int	Client ID for Verify Liveness BIOID
image01*	string	Image 01
photo*	string	Photo

Request Example :

curl --location 'https://faceverify-api.divasinergi.com/sanbox/verify/liveness' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data '{
    "id": "1",
    "photo": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/",
    "image01": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/"
}'

Response Example :

{
    "success": true,
    "statusCode": 200,
    "message": "Match Level : LEVEL_5, Score  : 72.64 % Liveness : True, Liveness Score : 100.00",
    "data": {
        "live": true,
        "errors": [],
        "status": "SUCCEEDED",
        "liveness_score": 1,
        "image_properties": {
            "0": {
                "faces": [
                    {
                        "left_eye": {
                            "x": 710.2469517570762,
                            "y": 356.2550519154349
                        },
                        "right_eye": {
                            "x": 586.9544283228709,
                            "y": 354.673923038717
                        },
                        "movement_direction": 0,
                        "motion_liveness_score": 0,
                        "texture_liveness_score": 1
                    }
                ],
                "rotated": 0,
                "frame_number": 0,
                "quality_score": 0,
                "quality_assessments": []
            }
        },
        "photo_properties": {
            "faces": [
                {
                    "left_eye": {
                        "x": 470.7382660803973,
                        "y": 706.6919898261713
                    },
                    "right_eye": {
                        "x": 330.14632919634005,
                        "y": 712.5702470452006
                    },
                    "movement_direction": 0,
                    "motion_liveness_score": 0,
                    "texture_liveness_score": 0
                }
            ],
            "rotated": 0,
            "frame_number": 0,
            "quality_score": 0,
            "quality_assessments": [
                {
                    "check": "ImageSize",
                    "score": 0.3703768318213538,
                    "message": "Image has been scaled down from 5732x4320 to 2123x1600 pixels."
                }
            ]
        },
        "verification_level": "LEVEL_5",
        "verification_score": 0.7264287795486151
    },
    "rows": 8,
    "apiCost": {
        "start": "2026-03-31 16:54:58'369",
        "finish": "2026-03-31 16:55:03'702",
        "duration": 5.333
    }
}

POST /sanbox/verify/kyc

Request Body :

Name	Type	Description
id*	int	Client ID for KYC BIOID
name*	string	Name
desc	string	Description ( Optional )
image01*	string	Image 01
image02*	string	Image 02
photo*	string	Photo

Request Example :

curl --location 'https://faceverify-api.divasinergi.com/sanbox/verify/kyc' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data '{
    "id": "1",
    "desc": "Description user (optional)",
    "name": "user",
    "photo": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/",
    "image01": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/",
    "image02": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/"
}'

Response Example :

{
    "success": true,
    "statusCode": 200,
    "message": "OK",
    "data": {
        "errors": [],
        "status": "SUCCEEDED",
        "enrolled_images": 1,
        "template_status": {
            "tags": [],
            "classId": "74",
            "enrolled": {
                "nanos": 754901600,
                "seconds": "1774950977"
            },
            "available": true,
            "thumbnails": [],
            "encoder_version": 5,
            "feature_vectors": 1,
            "thumbnails_stored": 1
        },
        "image_properties": {
            "0": {
                "faces": [
                    {
                        "left_eye": {
                            "x": 710.2469517570762,
                            "y": 356.2550519154349
                        },
                        "right_eye": {
                            "x": 586.9544283228709,
                            "y": 354.673923038717
                        },
                        "movement_direction": 0,
                        "motion_liveness_score": 0,
                        "texture_liveness_score": 0
                    }
                ],
                "rotated": 0,
                "frame_number": 0,
                "quality_score": 0,
                "quality_assessments": []
            }
        },
        "performed_action": "NEW_TEMPLATE_CREATED"
    },
    "rows": 6,
    "apiCost": {
        "start": "2026-03-31 16:56:12'074",
        "finish": "2026-03-31 16:56:18'264",
        "duration": 6.19
    }
}

POST /sanbox/bioid/onetomany

Request Body :

Name	Type	Description
id*	int	Client ID For Face Search
image01*	string	Image 01
image02*	string	Image 02

Request Example :

curl --location 'https://faceverify-api.divasinergi.com/sanbox/bioid/onetomany' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data '{
    "id": "1",
    "image01": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/",
    "image02": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/"
}'

Response Example :

{
    "statusCode": 200,
    "success": true,
    "message": "OK",
    "data": {
        "errors": [],
        "result": {
            "matches": [
                {
                    "classId": "80",
                    "score": 0.8277429899882078
                }, {
                    "classId": "77",
                    "score": 0.7758087027909393
                }, {
                    "classId": "79",
                    "score": 0.7701297064757864
                }, {
                    "classId": "21",
                    "score": 0.7693326316502018
                }, {
                    "classId": "78",
                    "score": 0.7679579369186089
                }, {
                    "classId": "93",
                    "score": 0.7636370040992827
                }, {
                    "classId": "22",
                    "score": 0.726465276063316
                }, {
                    "classId": "91",
                    "score": 0.7263564865237335
                }, {
                    "classId": "24",
                    "score": 0.7120259337752303
                }, {
                    "classId": "20",
                    "score": 0.7000848770186817
                }, {
                    "classId": "95",
                    "score": 0.699172735072108
                }, {
                    "classId": "94",
                    "score": 0.698338401729305
                }, {
                    "classId": "81",
                    "score": 0.6806226229841599
                }, {
                    "classId": "19",
                    "score": 0.6806213717348443
                }, {
                    "classId": "76",
                    "score": 0.6759869244249892
                }, {
                    "classId": "64",
                    "score": 0.6187052088258079
                }
            ]
        },
        "status": "SUCCEEDED",
        "image_properties": {
            "0": {
                "faces": [
                    {
                        "left_eye": {
                            "x": 296.1859487226097,
                            "y": 307.2963451049782
                        },
                        "right_eye": {
                            "x": 187.139659311279,
                            "y": 308.5682670403912
                        },
                        "texture_liveness_score": 0,
                        "motion_liveness_score": 0,
                        "movement_direction": 0
                    }
                ],
                "quality_assessments": [],
                "rotated": 0,
                "quality_score": 0,
                "frame_number": 0
            },
            "1": {
                "faces": [
                    {
                        "left_eye": {
                            "x": 296.1859487226097,
                            "y": 307.2963451049782
                        },
                        "right_eye": {
                            "x": 187.139659311279,
                            "y": 308.5682670403912
                        },
                        "texture_liveness_score": 0,
                        "motion_liveness_score": 0,
                        "movement_direction": 0
                    }
                ],
                "quality_assessments": [],
                "rotated": 0,
                "quality_score": 0,
                "frame_number": 1
            }
        },
        "matches": [
            {
                "id": 1,
                "parent": "39EC-A795-43AA-7B",
                "code": "7F71-4D0F-8FEE-3",
                "name": "haloom",
                "image": {
                    "bucket": "bioid-bws3",
                    "fileName": "photo/Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject",
                    "inKb": "34.07",
                    "inMb": "0.03",
                    "inGb": "0.0000",
                    "contentType": "image/jpeg",
                    "fileUrl": "https://bioid-bws3.is3.cloudhost.id/photo/Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject"
                }
            }
        ]
    },
    "rows": 5,
    "apiCost": {
        "start": "2026-04-06 10:44:20'706",
        "finish": "2026-04-06 10:44:31'153",
        "duration": 10.447
    }
}

POST /sanbox/bioid/get/template

Request Body :

Name	Type	Description
id*	int	Client ID For Get Template

Request Example :

curl --location 'https://faceverify-api.divasinergi.com/sanbox/bioid/get/template' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data '{
    "id": "1"
}'

Response Example :

{
    "statusCode": 200,
    "success": true,
    "message": "OK",
    "data": {
        "classId": "11",
        "available": true,
        "enrolled": {
            "seconds": "1773377266",
            "nanos": 306173700
        },
        "encoder_version": 5,
        "feature_vectors": 1,
        "thumbnails_stored": 1,
        "thumbnails": [
            {
                "image": "iVBORw0KGgoAAAANSUhEUgAAAy8AAAQ/CAIAAACSPkRyAAAMfWlDQ1BJQ0MgUHJvZmlsZQAAeAGtV2dYE8sani1JCBACBCIgJfQmiNQAUkIPoHQQRCUk"
            }
        ],
        "temp_count": 1
    },
    "rows": 8,
    "apiCost": {
        "start": "2026-04-06 10:31:36'243",
        "finish": "2026-04-06 10:31:42'343",
        "duration": 6.1
    }
}

APIDOC

Welcome to the official API documentation

Getting Started with Our API

Authentication

API Reference

Client BIOID Things - This section will be used to learning a several function how enrollment and authentication works on BIOID.

Client BIOID Get Token - Client Get token BIOID

Client Enroll Mobile - Client Enrollment a new template user.

Client Enroll Virtual - Client Enrollment a new template user using virtual.

Client Authentication Liveness - Client Authentication liveness check person.

Client Authentication Passive - Client Authentication passive check person.

Client Photo Verify - Client Photo verify check user.

Client KYC - Client KYC verification user.

Client Face Search - Client One-to-Many Mapping

Client Get Template - Client Get Registered Templates