For the complete documentation index, see llms.txt. You can also append .md to any page URL to get its markdown version.
Skip to main content
For the complete documentation index, see llms.txt.

For the complete documentation index, see llms.txt

DVV Finland

The Finnish Population Information System (Väestötietojärjestelmä, VTJ) is Finland's national population register. It holds official records of people registered as residents in Finland, including verified name and address data.

The Digital and Population Data Services Agency (Digi- ja väestötietovirasto, DVV) maintains the register. The agency was formerly known as the Population Register Centre (Väestörekisterikeskus, VRK).

Use fi-dvv for identity verification, Know Your Customer (KYC) onboarding and address enrichment or confirmation for one-time lookups during onboarding. For continuous change detection on a person's record, use Signicat's Ongoing Monitoring product. Ongoing Monitoring uses a separate Bisnode-based Finnish integration.

Properties​

Data attributes​

The Data Verification API provides the following attributes from DVV (fi-dvv) through the Basic endpoint:

  • Name
  • Various address types
  • Date of birth
  • Date of death

Approval process​

Access to VTJ data requires a data permit (tietolupa) granted by DVV, whether you access the register directly or through a reseller. Signicat holds a framework data permit covering fi-dvv. You must also obtain customer-level approval under this permit before accessing the source. Activating the source alone does not grant approval.

The Signicat Onboarding team handles the approval process together with you as part of setting up your account for fi-dvv. You may need to answer queries from DVV during the process.

Before using the source in production, contact your Signicat account manager or onboarding contact to initiate the approval process.

API requests​

To retrieve data from DVV through the Person Basic endpoint, send a request like the following:

GET https://api.signicat.com/info/lookup/countries/FI/persons?identityNumber=<PERSONAL_IDENTITY_CODE>&source=fi-dvv&rawJson=true

Set the country path parameter to FI, the ISO 3166-1 alpha-2 country code for Finland. Use the following query parameters:

  • source: The data provider to query. Use fi-dvv.
  • identityNumber: The person's Finnish personal identity code (henkilötunnus in Finnish or personbeteckning in Swedish).
  • rawJson: When set to true, includes the unnormalised source payload alongside the normalised response.

Test data​

Use the following personal identity codes to test fi-dvv in the sandbox environment. The scenarios may change as the source data changes:

  • 021019A950W: Person with two guardians and no permanent address.
  • 251199-999S: Person with a date of death.
  • 020143-998C: Person with a permanent address in Estonia and a home municipality outside Finland.
  • 231162-999X: Person whose name contains special characters.
  • 080626-998W: Person whose address contains only a postal code and post office. The person also has a poste restante address.

For more test data, contact Signicat Support by creating a support ticket in the Signicat Dashboard.