/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

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 email 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"
}

5.Sample

results matching ""

    No results matching ""