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 and testing 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

Production APIs and certificates that already exist have been copied to the service. History data on certificates that have expired or that have not been retrieved has not been imported.

When you sign in to the ‘Production certificates’ or ‘Testing certificates’ section 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.