This section is intended for software developers.
The Incomes Register's technical interfaces allow automating reporting and data use.
This section is intended for software developers.
The Incomes Register's technical interfaces allow automating reporting and data use.
See our contact channels for software developers and update your software’s contact person details.
Service breaks in the Incomes Register
Report a technical error or malfunction in the Incomes Register
See our technical instructions. The instructions relate to records that are provided or distributed through interfaces or the e-service’s upload service.
You need a certificate if you want to submit data or retrieve data through APIs.
Submit an application for using the technical interface in the Incomes Register's e-service
By the end of 2024, certificate requesting will move to the Finnish Tax Administration’s certificate service.
In stakeholder testing, you can test e-service and the interoperability of your software with a specific technical interface.
The interface means an electronic connection built between different systems and the Incomes Register.
The Incomes Registers offers several technical interface for data submitters and users. The data format of the Incomes Register’s technical interfaces is XML, and schemas are in English.
Software developers need to ensure that the built service corresponds to the Incomes Register’s technical documentation and schedule requirements. Consider the following:
Read all the recommendations for using the interface in the content descriptions submitting data to the Incomes Register and distribution of data from the Incomes Register.
You can report data using the real-time or deferred Web Service interface, or the SFTP interface.
Payers, or data providers, need to submit an application for using the technical interface in the Incomes Register's e-service.
Application for using the technical interface and certificate
The data saved in the Incomes Register can only be used by the authorities and other parties that have a statutory right to use them.
The Incomes Register’s data can be distributed using the SFTP interface and the real-time Web Service interface.
Data users need to submit an application for using the technical interface by filling in a report by the Incomes Register data user for data permission purposes. The provision of the data permission starts the first certificate request. When their data permission is in effect, organisations can request more certificates in the Incomes Register's e-service.