Command Palette
Search for a command to run...
Search for a command to run...
Information about all persons registered in Finland
Population Register
https://api.roaring.io/fi/person/1.0/extended/{personalNumber}Parameters path
personalNumberrequired | stringPersonal number to query for |
Response schema: application/json
https://api.roaring.io/fi/person/1.0/fatca/{personalNumber}Parameters path
personalNumberrequired | stringPersonal number to query for |
https://api.roaring.io/fi/person/1.0/full/{personalNumber}Parameters path
personalNumberrequired | stringPersonal number to query for |
https://api.roaring.io/fi/person/1.0/aml/{personalNumber}Parameters path
personalNumberrequired | stringPersonal number to query for |
https://api.roaring.io/fi/person/1.0/basic/{personalNumber}Parameters path
personalNumberrequired | stringPersonal number to query for |
https://api.roaring.io/fi/person/1.0/custody/{personalNumber}Parameters path
personalNumberrequired | stringPersonal number to query for |
Reach out to our support team.
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:
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 |
|---|---|---|---|---|---|
| Id | x | x | x | x | x |
| Name | x | x | x | x | x |
| Address | x | x | x | x | x |
| Domestic address, history (max three) | - | - | - | - | x |
| Foreign address, history (max three) | - | - | - | x | x |
| Contact address (only for secrecy marked) | - | - | - | - | x |
| Municipality | x | x | x | x | x |
| Mother Tongue code table 1 | x | - | x | - | x |
| Mother Tongue code table 2 | - | x | - | x | - |
| Death Information | x | x | x | x | x |
Rows per page
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 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 |
|---|---|---|---|
| 991 | Stateless | Kansalaisuudeton | Statslös |
| 997 | Not yet decided | Ei vielä selvitetty | Ej ännu utrett |
| 998 | Country is written as free text, code missing | — | Landskod saknas, landet skrivs med klartext |
| 999 | Unknown | Tuntematon | Okänt |
Code table 1 for endpoints Basic, Full and AML:
Code | Description EN | Description FI | Description SE |
|---|---|---|---|
| 1 | Finnish | Suomi | Finska |
| 2 | Swedish | Ruotsi | Svenska |
| 3 | Other | Muu | Annat |
Code table 2 for endpoints Extended and FATCA:
Code | Description EN | Description FI | Description SE |
|---|---|---|---|
| 1 | Finnish | Suomi | Finska |
| 2 | Swedish | Ruotsi | Svenska |
| 3 | Sami | Saame | Samiska |
| 4 | Other | Muu | Annat |
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.