/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	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 ""