Finland

Finland eKYC verification matches submitted individual data against Finland's source of truth using a sequenced search across multiple underlying data sources. See the eKYC API Reference for common response semantics that apply across all sources.

Available sources

FI National ID

Request parameters

Sample request

{
    "plugins": ["kyc"], //required field
    "source": "FI_NATIONAL_ID", //required field
    "firstName": "Matti", //required field
    "surName": "Virtanen", //required field
    "street": "Koivukuja 12 A 4",
    "city": "Lappeenranta",
    "state": "South Karelia",
    "postalCode": "53100",
    "country": "FI", //required field
    "dateOfBirth": "1991-08-02", //required field
    "idNumber": "010203A123X" //required field
}

Response fields

FI National ID anchors verification on the submitted national identity number, name, date of birth, and address elements. See the eKYC API Reference for common match field definitions and status values. Individual field matches for this source resolve to exact or nomatch only; fullAddressMatch additionally supports fuzzy.

overallLevel calculation

overallLevel is calculated based on the risk associated with the submitted full name, national identity number, and date of birth:

• low when fullNameMatch, idNumMatch, and dobMatch are all exact.
• high when fullNameMatch, idNumMatch, and dobMatch are all nomatch.
• medium for all other combinations.

Contact your Incode representative to customize the overallLevel calculation for your use case.

Sample response

{
    "kyc": [
        { "key": "firstNameMatch", "status": "exact" },
        { "key": "lastNameMatch", "status": "exact" },
        { "key": "fullNameMatch", "status": "exact" },
        { "key": "dobMatch", "status": "exact" },
        { "key": "idNumMatch", "status": "exact" },
        { "key": "streetMatch", "status": "exact" },
        { "key": "cityMatch", "status": "exact" },
        { "key": "stateMatch", "status": "exact" },
        { "key": "postalCodeMatch", "status": "exact" },
        { "key": "fullAddressMatch", "status": "exact" },
        { "key": "overallLevel", "status": "low" }
    ]
}

Finland Consumer + Pop Register + Telco

Request parameters

Sample request

{
    "plugins": ["kyc"], //required field
    "source": "FI_CONSUMER_POP_REG_TELCO", //required field
    "firstName": "Mikko", //required field
    "surName": "Virtanen", //required field
    "phone": "+358401234567", //required field
    "country": "FI", //required field
    "street": "Mannerheimintie", //optional field
    "houseNo": "45", //optional field
    "city": "Helsinki", //optional field
    "postalCode": "00100", //optional field
    "dateOfBirth": "1991-08-02", //optional field
    "gender": "m", //optional field
    "email": "mikko.virtanen@example.com" //optional field
}

Response fields

Finland Consumer + Pop Register + Telco anchors verification on individual name and phone number. See the eKYC API Reference for common match field definitions and status values.

overallLevel calculation

overallLevel is calculated based on the risk associated with the submitted full name and phone number:

• low when fullNameMatch is exact AND phoneMatch is exact.
• high when fullNameMatch is nomatch OR phoneMatch is nomatch.
• medium for all other combinations.

Contact your Incode representative to customize the overallLevel calculation for your use case.

Sample response

{
    "kyc": [
        { "key": "firstNameMatch", "status": "exact" },
        { "key": "lastNameMatch", "status": "exact" },
        { "key": "fullNameMatch", "status": "exact" },
        { "key": "dobMatch", "status": "exact" },
        { "key": "genderMatch", "status": "exact" },
        { "key": "streetMatch", "status": "exact" },
        { "key": "houseNoMatch", "status": "exact" },
        { "key": "streetAddressMatch", "status": "exact" },
        { "key": "cityMatch", "status": "exact" },
        { "key": "postalCodeMatch", "status": "exact" },
        { "key": "fullAddressMatch", "status": "exact" },
        { "key": "phoneMatch", "status": "exact" },
        { "key": "emailMatch", "status": "exact" },
        { "key": "overallLevel", "status": "low" }
    ]
}