/verify/id_selfie
1.API Specification
2.Request Params
3.Response Params
4.Error Codes
5.Sample
1.API Specification
This API is used to verify Indonesian ID Card Number and Selfie Image.
Request Method
POST
Request URL
https://cloudapi.indonesia.accuauth.com/verify/id_selfie
Debugging Tool
2.Request Params
2.1 Request Header
Parameter | Type | Required | Description |
---|---|---|---|
X-DF-API-ID | string | Yes | For API credentials,Please visit API Request |
X-DF-API-SECRET | string | Yes | For API credentials,Please visit API Request |
2.2 Request Body
Required | Fields | Type | Description |
---|---|---|---|
required | id_number | string | ID number |
required | face_image | string | Base64 encoded selfie image, image size must be limited to 50KB |
optional | ktp_image | string | Base64 encoded card image, image size must be limited to 50KB |
optional | string | Email address | |
optional | phone_number | string | Phone number |
optional | birth_date | string | birth date, format as YYYY-MM-DD |
optional | name | string | Name |
optional | face_threshold | float | Face similarity threshold |
3.Response Params
Fields | Type | Description |
---|---|---|
request_id | string | Unique id of each request |
status | string | Response status, OK for success request, Error Codes for failed request |
result | object | The verification result |
3.1 Elements in `result`
Fields | Type | Description |
---|---|---|
order_no | string | Unique order number |
handle_time | string | Handle time |
result | string | 01 : match (charged); 02 : mismatch (charged); 03 : not found (free); 04 : failed (free); 05 : not found from db (free); 06 : Channel failed (free); 07 : rate limited (free); 08 : no face detected(free) |
remark | string | Remark |
id_number | string | ID number |
face_percent | bool | Selfie face compare result |
ktp_face_percent | bool | Card face compare result |
face_score | float | Selfie face score |
ktp_face_score | float | Card face score |
name | bool | Compare result of name |
birth_date | bool | Compare result of birth date |
Response Syntax
{
"status": "OK",
"result": {
"order_no": "SFBw1091761941576552448",
"handle_time": "2025-06-30 16:32:10",
"result": "02",
"remark": "UNSAME",
"id_number": "3217061012870001",
"face_percent": false,
"ktp_face_percent": false,
"face_score": 53.3,
"ktp_face_score": 0.0,
"name": false,
"birth_date": false
},
"request_id": "TID07ecf99645e8452087c38252d1fccdca"
}
4.Error Codes
Common error codes of this API:
Http Status Code | Status Field |
Description |
---|---|---|
400 |
INVALID_ARGUMENT | Request parameter is invalid |
400 |
QUERY_FAILED | Query failed |
400 |
ABNORMAL_BEHAVIOURS_DETECTED | Request with same parameters repeated more than amount of times |
401 |
UNAUTHORIZED | Unauthorized or access is denied |
401 |
KEY_EXPIRED | Your API ID has expired |
403 |
NO_PERMISSION | You are not authorized to use this API |
403 |
OUT_OF_QUOTA | API calls quota exceeded |
403 |
RATE_LIMIT_EXCEEDED | API request frequency exceeds the limit |
404 |
NOT_FOUND | Requested API cannot be found |
500 |
INTERNAL_ERROR | Internal server error |
512 |
SOURCE_SERVICE_UNAVAILABLE | Source service is unavailable |
513 |
SOURCE_SERVICE_TIMEOUT | Source service is timeout |
Comment: Please see the reason
field for details when the above 40X / 51X error occurred
Response Syntax
{
"status": "INVALID_ARGUMENT",
"reason": "argument 'id_number': not found",
"request_id": "TID8bf47ab6eda64476973cc5f5b6ebf57e"
}