Demography Verification

Demography verification to dukcapil database.

This module only support biometric verification for indonesian identity card (KTP)

Endpoints

Method	URL
POST	$synapses/v1/identity/verification/demography

Headers

Header	Value
Content-Type	application/json
Authorization	Bearer YOUR_API_KEY

Request

Description

Field	Type	Description
identityId (required)	String (len: 16)	Nomor induk kependudukan (NIK).
fullName (optional)	String	Full name.
birthPlace (optional)	String	Birth Place.
birthDate (optional)	String (format: yyyy-mm-dd)	Birth Date.
address (optional)	String	Address.
threshold (optional)	Float (0-1)	Matched threshold for demography data (fullName, birthPlace, address) - 0=0% match, 0.5=50% match, 1=100% match

Example

Testing

In the sandbox environment, we only response api call with dummy data. To get valid response data, you can use our production environment instead.

All Match

You can use identityId = 1234567890123456 to produce face not match result.

Example:

{
    "identityId": "1234567890123456",
    "fullName": "ASEP SUPRIYADI",
    "address": "JL SESAMA NO 123",
    "birthPlace": "JAKARTA",
    "birthDate": "1990-07-06"
}

{
    "message": "Identity demography verification succeeded.",
    "data": {
        "id": "43ad6108-a5ce-452f-8603-d60d24c2ef3e",
        "identityId": "1234567890123456",
        "isValid": true,
        "isActive": true,
        "response": {
            "fullName": true,
            "fullNameSimilarity": 1.0,
            "address": true,
            "addressSimilarity": 1.0,
            "birthPlace": true,
            "birthPlaceSimilarity": 1.0,
            "birthDate": true
        }
    }
}

Wrong Identity

Wrong Name

Wrong Address

Wrong Birthplace

Wrong Birthdate

Response

Description

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.

Example

Errors

Please read this page <Responses & Errors> to know more about response.

Error 4XX

Error Type

Error Type	Description	Is charged?
request_error	Cannot get response from Dukcapil server.	False

Structure

Error 5XX

For every 5XX http code response, there will be no charge.