There may be occasional breaks in the service due to maintenance. We apologise for any inconvenience.
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:
- the Tax Administration’s APIs;
- the Incomes Register’s APIs; and
- the Positive credit register’s APIs.
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.
Testing certificates
The section will be opened on 11 December 2024, at 9 am.
If there is an error, do this
Report any technical observations or disruptions using the certificate service’s observation form
Read the instructions for revoking production certificates
Read the instructions for renewing certificates
Check maintenance breaks and disruptions affecting the Tax Administration’s services