EMEA
Finland
Finland National ID
4 min
verifies input data from the central finnish identity card number issued by the government of finland for authorization get session token from authentication page name finland national id method post url https idu test datazoo com api v2 verify description verification outcome returns kyc verification n consumer consent n a n mandatory input name dob and id finnish identity card number n verifies name dob address and id n returned data status related to id person register number 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 eyjpc3mioij0zxn0iiwiawf0ijoxnzqzmdy2ntuwlcjpcgeioiiznc4xnteumte3lji0osisinvpzci6mzazlcjvawqiojyylcjsawqioju2mzexnzksimv4cci6mtc0mza5ntm1mcwiyxvkijoiahr0chm6ly9pzhuuzgf0yxpvby5jb20ifq lybxrxlcq2gieo w0vqchmy0x5hdkfihlp4nu2 vfrxytcdsmvcqchr5orcpij9gz3ba88z4 dc3hvdep2utgq n data n countrycode fi n service n finland national id n n clientreference test 0001 n firstname anna liisa n lastname kovalainen n dateofbirth 1949 01 01 n addresselement1 pohjoisesplanadi 94 n addresselement3 helsinki n addresselement5 00180 n identityvariables n nationalidno 010149 352e n n n customlabel selectedlanguageid f2jmy98siubrop0bgc788 results languages id kllvb jxqiuu wuwqaf language 200 customlabel code n countrycode finland n clientreference test 0001 n reportingreference dz 3ac6e569 7ead 4b82 b82f 70d43831b32c n matchstatus full match 1 1 verification n searcherrormessage n safeharbour false n searchstatus successful n serviceresponses n finland national id 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 addresselement1 true n addresselement3 true n addresselement5 true n dateofbirth true n firstname true n lastname true n nationalidno true n n returneddata n personstatus active n nationalidno 010149 352e 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 fi name service kind required type array description finland national id 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 n see the note below for more details name firstname kind required type string description the first name of the identity owner n see the note below for more details name lastname kind required type string description the last name of the identity owner n see the note below for more details name dateofbirth kind required type string description in yyyy mm dd preferred or dd mm yyyy format name addresselement1 kind optional type string description the house unit number and street name of the address name addresselement3 kind optional type string description the town city of the address children name addresselement5 kind optional type string description the post code of the address children name identityvariables kind required type object description other elements for verification children name nationalidno kind required type string description finnish identity card number of the identity owner schema name countrycode kind required type string description fi name service kind required type array description finland national id 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 n see the note below for more details name firstname kind required type string description the first name of the identity owner n see the note below for more details name lastname kind required type string description the last name of the identity owner n see the note below for more details name dateofbirth kind required type string description in yyyy mm dd preferred or dd mm yyyy format name addresselement1 kind optional type string description the house unit number and street name of the address name addresselement3 kind optional type string description the town city of the address children name addresselement5 kind optional type string description the post code of the address children name identityvariables kind required type object description other elements for verification children name nationalidno kind required type string description finnish identity card number of the identity owner formdataparameters currentnewparameter label body parameter value bodydataparameters hastryitout false response name countrycode kind optional type string description finland 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 finland national id 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 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 addresselement3 kind optional type boolean description name addresselement5 kind optional type boolean description name dateofbirth kind optional type boolean description name firstname kind optional type boolean description name fullname kind optional type boolean description name lastname kind optional type boolean description name nationalidno kind optional type boolean description name returneddata kind optional type object description null children name personstatus kind optional type string description active inactive etc name nationalidno kind optional type string description name remarks kind optional type array description will return remarks regarding any encountered issues children mandatory input for name either of the following must be provided ( firstname + lastname ) mandatory when fullname is not provided fullname is mandatory when ( firstname + lastname ) are not provided links