Roaring logo
Log in

Population Register

Information about all persons registered in Finland

Population Register

[fi]
Requires addon

Documentation

Retrieve Identity Data with Population Register API. The Population Register API provides verified identity and residency information, helping businesses strengthen due diligence, meet AML/KYC requirements, and prevent fraud. It enables secure, compliant decision-making by ensuring access to up-to-date personal data. With this API, you can:

  • Retrieve address information, names, relationships, and historical data from social security numbers
  • Create frictionless B2C onboarding and checkout flows
  • Verify individual identities for risk assessments

Use case:

A financial institution onboarding a new private (B2C) customer uses the Population Register API to instantly verify the customer's identity and address, ensuring fast, secure registration while meeting compliance requirements.

Endpoint differences

Endpoint
Basic
Extended
Full
FATCA
AML
Idxxxxx
Namexxxxx
Addressxxxxx
Domestic address, history (max three)----x
Foreign address, history (max three)---xx
Contact address (only for secrecy marked)----x
Municipalityxxxxx
Mother Tongue code table 1x-x-x
Mother Tongue code table 2-x-x-
Death Informationxxxxx

Rows per page

Page 1 of 2

Apply for Production Data

In order to access population registry data through Roaring you need to apply for access via the admin pages of app.roaring.io.

This API requires permission. In order for you to get started you need to apply for this through your account. Access ADMIN, Account information, Permissions.

Person Basic

Is used by customer organization to check a persons name and address and if the customer is alive in a customer validation situation. The customer is informed of the validation. Approval from the Finnish digital and population data services agency is mandatory to use this service.

Person Extended

Is used by customer organization to check a persons name and address and if the customer is alive in a customer validation situation regarding finance, credit, loans and insurance or brokerage of finance, credit, loans and insurance . Is also used to validate a tenant. The customer is informed of the validation. Approval from the Finnish digital and population data services agency is mandatory to use this service.

Person Full

Is used by customer organization to check a persons name and address and if the customer is alive in a customer validation situation regarding finance, credit, loans and insurance or brokerage of finance, credit, loans and insurance . Is also used to validate a tenant. The customer is informed of the validation. Approval from the Finnish digital and population data services agency is mandatory to use this service.

Custody

Is used by customer organization to review the information about a minor creditor and to validate information about guardians regarding child maintenance or when guardians are required in a legal action such as opening a bank account for a minor. The customer is informed of the validation. The customer organization have to have an authorization under the Finance Inspectorate. Approval from the Finnish digital and population data services agency is mandatory to use this service.

Permission to Population Register

In order to get access to the government managed API’s for population registry information you need a permission. Roaring will help you with the application process.

Country Codes

Country codes are in ISO 3166 standard, three digits.

In addition to the ISO 3166 standard, the below country codes are possible:

Code
Description English
 Description Finnish
Description Swedish
991StatelessKansalaisuudetonStatslös
997Not yet decidedEi vielä selvitettyEj ännu utrett
998Country is written as free text, code missingLandskod saknas, landet skrivs med klartext
999UnknownTuntematonOkänt

Mother Tounge Codes

Code table 1 for endpoints Basic, Full and AML:

Code
Description EN
Description FI
Description SE
1FinnishSuomiFinska
2SwedishRuotsiSvenska
3OtherMuuAnnat

Code table 2 for endpoints Extended and FATCA:

Code
Description EN
Description FI
Description SE
1FinnishSuomiFinska
2SwedishRuotsiSvenska
3SamiSaameSamiska
4OtherMuuAnnat

Endpoints

AML

gethttps://api.roaring.io/fi/person/1.0/aml/{personalNumber}

Parameters path

personalNumber

required

string
Personal number to query for

Response schema: application/json

Person Basic

gethttps://api.roaring.io/fi/person/1.0/basic/{personalNumber}

Parameters path

personalNumber

required

string
Personal number to query for

Custody

gethttps://api.roaring.io/fi/person/1.0/custody/{personalNumber}

Parameters path

personalNumber

required

string
Personal number to query for

Person Extended

gethttps://api.roaring.io/fi/person/1.0/extended/{personalNumber}

Parameters path

personalNumber

required

string
Personal number to query for

FATCA

gethttps://api.roaring.io/fi/person/1.0/fatca/{personalNumber}

Parameters path

personalNumber

required

string
Personal number to query for

Person Full

gethttps://api.roaring.io/fi/person/1.0/full/{personalNumber}

Parameters path

personalNumber

required

string
Personal number to query for