Full Verification
Demography and Biometric verification to dukcapil database.
Last updated
Demography and Biometric verification to dukcapil database.
Last updated
This module only support verification for indonesian identity card (KTP)
Method
URL
POST
$synapses
/v1/identity/verification/full
Header
Value
Content-Type
application/json
Authorization
Field
Type
Description
identityId
(required)
String
(len: 16)
Nomor induk kependudukan (NIK).
fullName
(required)
String
Full name.
birthPlace
(required)
String
Birth Place.
birthDate
(required)
String
(format: yyyy-mm-dd)
Birth Date.
address
(required)
String
Address.
faceImage
(required)
Base64
Image binary encoded in base64 without <data:image/png;>. - Supports: JPG, JPEG, PNG, SVG - Max Size: 1MB
threshold
(optional)
Float (0-1)
Matched threshold for demography data (fullName, birthPlace, address) - 0=0% match, 0.5=50% match, 1=100% match
faceThreshold
(optional)
(0-1)
Matched threshold for biometric data (face) - 0=0% match, 0.5=50% match, 1=100% match
In the sandbox environment, we only response api call with dummy data. To get valid response data, you can use our production environment instead.
You can use identityId=1234567890123456
to produce all-match result.
Example:
Field
Type
Description
id
String
Unique identifier.
identityId
String
Nomor induk kependudukan (NIK).
isValid
Boolean
Return true if identityId is exist in the Dukcapil database.
isActive
Boolean
Return true if identityId is active in the Dukcapil database.
response:fullName
Boolean
Return true if input fullName match with the fullName in Dukcapil database.
response:fullNameSimilarity
Float
(0-1)
Similarity between the input fullName and the fullName in Dukcapil database.
response:address
Boolean
Return true if input birth date match with the birth date in Dukcapil database.
response:addressSimilarity
Float
(0-1)
Similarity between the input address and the address in Dukcapil database.
response:birthPlace
Boolean
Return true if input birth place match with the birth place in Dukcapil database.
response:birthPlaceSimilarity
Float
(0-1)
Similarity between the input birthPlace and the birthPlace in Dukcapil database.
response:birthDate
Boolean
Return true if input birth date match with the birth date in Dukcapil database.
response:face
Boolean
Return true if input face match with the face in dukcapil database. - Default threshold: >= 0.75: True
response:faceSimilarity
Float
(0-1)
Similarity between the input face and the face in Dukcapil database. - Default threshold: >= 0.8: True
Please read this page <Responses & Errors> to know more about response.
Error 4XX
invalid_base64_encoding
Invalid base64 encoding.
False
image_too_large
Input image is greater than the maximum size allowed.
False
no_face_detected
No face was detected from the input image or the input image is blurry.
True
request_error
Cannot get response from Dukcapil server.
False
Error 5XX
For every 5XX http code response, there will be no charge.
Bearer