APAC
Indonesia
Indonesia Resident Identity Card
4 min
verifies input data from the resident identity card (nik) issued by the indonesian ministry of home affairs mandatory identity document for all citizens aged 17 and above for authorization get session token from authentication page { "name" "indonesia resident identity card", "method" "post", "url" "https //idu test datazoo com/api/v2/verify", "description" " verification outcome – returns kyc verification\n consumer consent – yes\n mandatory input – name, dob and national id\n verifies – name, address, dob and national id\n returned data full address and full name (if configured)", "tab" "examples", "examples" { "languages" \[ { "id" "f2jmy98siubrop0bgc788", "language" "curl", "code" "curl location 'https //idu test datazoo com/api/v2/verify' \\\\\n header 'content type application/json' \\\\\n header 'authorization bearer eyjhbgcioijiuzuxmiisinr5cci6ikpxvcj9 eyjpc3mioij0zxn0iiwiawf0ijoxnzqymty4ntm5lcjpcgeioiiznc4xnteumte3lji0osisinvpzci6mzazlcjvawqiojyylcjsawqioju1njkwmtasimv4cci6mtc0mje5nzmzoswiyxvkijoiahr0chm6ly9pzhuuzgf0yxpvby5jb20ifq nxwbno3oamwedxxai 99t2zus9p imgpyjupmwldk9rg 0fcaizhldyao dnv4blqn 3vfn62hvskklxrjbulw' \\\\\n data '{\n \\"countrycode\\" \\"id\\",\n \\"service\\" \[\n \\"indonesia resident identity card\\"\n ],\n \\"clientreference\\" \\"test 0001\\",\n \\"fullname\\" \\"fury indah puspitasari\\",\n \\"gender\\" \\"female\\",\n \\"dateofbirth\\" \\"1989 09 07\\",\n \\"fulladdress\\" \\"gg rawa elok 2 no 42, kramatjati, jakarta timur\\",\n \\"addresselement1\\" \\"gg rawa elok 2 no 42\\",\n \\"addresselement2\\" \\"kramatjati\\",\n \\"addresselement5\\" \\"jakarta timur\\",\n \\"consentobtained\\" {\n \\"indonesiaresidentidentitycard\\" true\n },\n \\"identityvariables\\" {\n \\"nik\\" \\"3276052203830087\\" \n }\n}\n'", "customlabel" "" } ], "selectedlanguageid" "f2jmy98siubrop0bgc788" }, "results" { "languages" \[ { "id" " kllvb jxqiuu wuwqaf", "language" "200", "customlabel" "", "code" "{\n \\"countrycode\\" \\"indonesia\\",\n \\"clientreference\\" \\"test 0001\\",\n \\"reportingreference\\" \\"dz b32e438a 06b9 4c8d ad68 0a597d7c11de\\",\n \\"matchstatus\\" \\"full match 1+1 verification\\",\n \\"searcherrormessage\\" \\"\\",\n \\"safeharbour\\" false,\n \\"searchstatus\\" \\"successful\\",\n \\"serviceresponses\\" {\n \\"indonesia resident identity card\\" {\n \\"status\\" 0,\n \\"sourcestatus\\" \\"successful\\",\n \\"errormessage\\" \\"\\",\n \\"identityverified\\" true,\n \\"safeharbourscore\\" \\"l1\\",\n \\"namematchscore\\" \\"1 000\\",\n \\"addressmatchscore\\" \\"1 000\\",\n \\"verifications\\" {\n \\"dateofbirth\\" true,\n \\"fulladdress\\" true,\n \\"fullname\\" true,\n \\"gender\\" true,\n \\"nik\\" true\n },\n \\"returneddata\\" {\n \\"address\\" \\"gg rawa elok 2 no 42, kramatjati, jakarta timur\\"\n }\n }\n },\n \\"remarks\\" \[]\n}" }, { "id" "as5tj4glqvhlg7b69q21j", "language" "404", "customlabel" "", "code" "{\n \\"message\\" \\"ain't no cake like that \\"\n}" } ], "selectedlanguageid" " kllvb jxqiuu wuwqaf" }, "request" { "pathparameters" \[], "queryparameters" \[], "headerparameters" \[ { "name" "authorization", "kind" "required", "type" "string", "description" "sessiontoken obtained via the authentication call", "" "sessiontoken obtained via the authentication call" } ], "bodydataparameters" \[ { "name" "data", "kind" "required", "type" "object", "description" "request body sent to the api", "" "object", "children" \[ { "name" "countrycode", "kind" "required", "type" "string", "description" "id" }, { "name" "service", "kind" "required", "type" "array", "description" "indonesia resident identity card" }, { "name" "clientreference", "kind" "optional", "type" "string", "description" "a client reference field" }, { "name" "fullname", "kind" "required", "type" "string", "description" "the full name of the identity owner" }, { "name" "gender", "kind" "optional", "type" "string", "description" "male or female" }, { "name" "dateofbirth", "kind" "required", "type" "string", "description" "in yyyy mm dd (preferred) or dd mm yyyy format" }, { "name" "fulladdress", "kind" "optional", "type" "string", "description" "the full address (address elements separated by commas) of the identity owner\n see the note below for more details " }, { "name" "addresselement1", "kind" "optional", "type" "string", "description" "street level address of the identity owner\n see the note below for more details " }, { "name" "addresselement2", "kind" "optional", "type" "string", "description" "the sub district of the identity owner\n see the note below for more details " }, { "name" "addresselement5", "kind" "optional", "type" "string", "description" "the district of the identity owner\n see the note below for more details " }, { "name" "identityvariables", "kind" "required", "type" "object", "description" "other elements for verification", "children" \[ { "name" "nik", "kind" "required", "type" "string", "description" "resident identity card (nik) number of the identity owner\n \[conditional optional see the note below for more details]" } ] }, { "name" "consentobtained", "kind" "required", "type" "object", "description" "consent given by the identity owner", "children" \[ { "name" "indonesiaresidentidentitycard", "kind" "required", "type" "string", "description" "should be true" } ] } ], "schema" \[ { "name" "countrycode", "kind" "required", "type" "string", "description" "id" }, { "name" "service", "kind" "required", "type" "array", "description" "indonesia resident identity card" }, { "name" "clientreference", "kind" "optional", "type" "string", "description" "a client reference field" }, { "name" "fullname", "kind" "required", "type" "string", "description" "the full name of the identity owner" }, { "name" "gender", "kind" "optional", "type" "string", "description" "male or female" }, { "name" "dateofbirth", "kind" "required", "type" "string", "description" "in yyyy mm dd (preferred) or dd mm yyyy format" }, { "name" "fulladdress", "kind" "optional", "type" "string", "description" "the full address (address elements separated by commas) of the identity owner\n see the note below for more details " }, { "name" "addresselement1", "kind" "optional", "type" "string", "description" "street level address of the identity owner\n see the note below for more details " }, { "name" "addresselement2", "kind" "optional", "type" "string", "description" "the sub district of the identity owner\n see the note below for more details " }, { "name" "addresselement5", "kind" "optional", "type" "string", "description" "the district of the identity owner\n see the note below for more details " }, { "name" "identityvariables", "kind" "required", "type" "object", "description" "other elements for verification", "children" \[ { "name" "nik", "kind" "required", "type" "string", "description" "resident identity card (nik) number of the identity owner\n \[conditional optional see the note below for more details]" } ] }, { "name" "consentobtained", "kind" "required", "type" "object", "description" "consent given by the identity owner", "children" \[ { "name" "indonesiaresidentidentitycard", "kind" "required", "type" "string", "description" "should be true" } ] } ] } ], "formdataparameters" \[] }, "currentnewparameter" { "label" "body parameter", "value" "bodydataparameters" }, "hastryitout" false, "response" \[ { "name" "countrycode", "kind" "optional", "type" "string", "description" "indonesia", "children" \[] }, { "name" "clientreference", "kind" "optional", "type" "string", "description" "the client reference (if given as input) ", "children" \[] }, { "name" "reportingreference", "kind" "optional", "type" "string", "description" "a reference number generated which is unique to each transaction ", "children" \[] }, { "name" "validationerrors", "kind" "optional", "type" "string", "description" "returned with http status code 400 when the request contains invalid or improperly formatted input data ", "children" \[] }, { "name" "matchstatus", "kind" "optional", "type" "string", "description" "\\"full match 1+1 verification\\" \n\\"no match\\" " }, { "name" "searcherrormessage", "kind" "optional", "type" "string", "description" "error message returned querying the data source", "children" \[] }, { "name" "safeharbour", "kind" "optional", "type" "boolean", "description" "true or false", "children" \[] }, { "name" "searchstatus", "kind" "optional", "type" "string", "description" "\\"successful\\" \n\\"not successful\\"", "children" \[] }, { "name" "serviceresponses", "kind" "optional", "type" "object", "description" "verification details with \\"indonesia resident identity card\\" returned as the service identifier ", "children" \[ { "name" "status", "kind" "optional", "type" "integer", "description" "0 identityverified true element verifications all true\n1 identityverified true element verifications not all true\n2 identityverified false sourcestatus successful\n3 identityverified false sourcestatus not successful" }, { "name" "sourcestatus", "kind" "optional", "type" "string", "description" "\\"successful\\"\n\\"unsuccessful\\"" }, { "name" "errormessage", "kind" "optional", "type" "string", "description" "error message(s) from the data source example, \\"error querying data source\\" " }, { "name" "identityverified", "kind" "optional", "type" "boolean", "description" "true or false" }, { "name" "safeharbourscore", "kind" "optional", "type" "string", "description" "m1, m2, n1, l1, l2, l3, l4, l5 or \\"none\\"\n for more information, refer to safe harbour scores page" }, { "name" "namematchscore", "kind" "optional", "type" "string", "description" "a string that acts as a value between 0 000 and 1 000 " }, { "name" "addressmatchscore", "kind" "optional", "type" "string", "description" "a string that acts as a value between 0 000 and 1 000 \n\\"n/a\\"" }, { "name" "verifications", "kind" "optional", "type" "object", "description" "element level verification returned as true or false\n\[only applicable elements will be included, and not all elements may be present]", "children" \[ { "name" "addresselement1", "kind" "optional", "type" "boolean", "description" "" }, { "name" "addresselement2", "kind" "optional", "type" "boolean", "description" "" }, { "name" "addresselement5", "kind" "optional", "type" "boolean", "description" "" }, { "name" "dateofbirth", "kind" "optional", "type" "boolean", "description" "" }, { "name" "fulladdress", "kind" "optional", "type" "boolean", "description" "" }, { "name" "fullname", "kind" "optional", "type" "boolean", "description" "" }, { "name" "gender", "kind" "optional", "type" "boolean", "description" "" }, { "name" "nik", "kind" "optional", "type" "boolean", "description" "" } ] }, { "name" "returneddata", "kind" "optional", "type" "object", "description" "returns additional data from the data source ", "children" \[ { "name" "address", "kind" "optional", "type" "string", "description" "full address of the individual " }, { "name" "fullname", "kind" "optional", "type" "string", "description" "fullname of the individual \n included or omitted based on the client's configured settings" } ] } ] }, { "name" "remarks", "kind" "optional", "type" "array", "description" "will return remarks regarding any encountered issues or pre validation errors ", "children" \[] } ] } optional address input either of the following elements from addresselement(s) when fulladdress is not provided fulladdress is when elements from addresselement(s) are not provided resident identity card input in the api call, the id number input can be omitted or set as optional based on the configuration in the client's account settings links