As of 12 May 2025, users who sing in to authorities’ e-services using strong identification will be prompted to activate Suomi.fi Messages. More information on activating Suomi.fi Messages is available on Digital First project | Digital and Population Data Services Agency.

Service break for the Incomes Register's stakeholder testing environment on  20 May, 12 noon – 21 May, 8 am.

Certificate service

You need a certificate if you want to submit data or retrieve data through technical interfaces (APIs). The technical interface means an integration built between different systems, for example, between payroll software and the Incomes Register.

Certificates are used to identify and authenticate the organisations that use an interface to report or retrieve data. They are also used to verify the integrity of records. The solution is based on digital certificates (Public Key Infrastructure).

Typical users of APIs are accounting firms and employer companies. The use of interfaces and certificates requires technical skills. Agree upon tasks and procedures with your software supplier.

Request test and production certificates from the Tax Administration's certificate service

The requesting of production certificates has been transferred, from the Incomes Register's e-service to the Finnish Tax Administration’s certificate service.

Test certificate: Submit an interface application and request a certificate in the Tax Administration’s certificate service

Production certificate: Submit an interface application and request a certificate in the Tax Administration’s certificate service

Also review other instructions for the Tax Administration's certificate service:

Renewal of certificate

Revoking a certificate

Technical instructions

Data delivery and distribution

You can find the interface descriptions related to the submission and distribution of Incomes Register earnings and benefits payment data, and the related application guidelines on the documentation page.

Page last updated 3/28/2025