The Tax Administration’s certificate service

The Tax Administration’s certificate service is an e-service in which you can manage your organisation’s API rights and certificates. The service is intended for businesses and organisations.

You need a certificate if you want to submit or retrieve data through APIs. For example, you can request data about an employee’s tax rate, submit your employees’ earnings payment data directly from your payroll software to the Incomes Register, or – if you are a lender – report loan contract data to the Positive credit register.

Use the certificate service to retrieve production certificates for the following:

Certificates are used to identify and authorise organisations that submit data or retrieve data through APIs. They are also used to verify the integrity of records. The solution is based on digital certificates (Public Key Infrastructure).

A certificate is valid for two years, after which it must be renewed. You can check the validity of a certificate on the certificate or by logging in to the certificate service. The new service will not affect the existing and currently valid certificates. All existing certificates remain functional throughout their validity period.

The use of APIs and certificates requires technical skills. Discuss with your software supplier the procedures related to using APIs.

When you log in to the service for the first time, check your organisation's details

 Valid APIs and certificates created before 24 October 2024 have been copied to the certificate service. History data on certificates that have expired or that have not been retrieved has not been imported.

When you log in to the service for the first time, check that your organisation has access to the APIs you need and update your organisation's contact person if necessary. Also check and update the organisation’s technical contact persons for certificates.

Production certificates

Submit an API application and request a production certificate.

Log in: Production certificates

Identify yourself using your online banking codes, a mobile certificate or a certificate card. Check when you also need a Suomi.fi authorisation.

Read the instructions for production certificates

Testing certificates

The section will be opened on 11 December 2024, at 9 am.

Read the testing instructions for different services

Page last updated 10/24/2024