Production certificates

Log in to the Tax Administration’s certificate service (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

In the list, select the company or organisation for which you are requesting an API access right and certificate. Once you have selected the organisation, you can see the APIs and certificates it already has.

Check that the information is up to date. Make sure your organisation has access to the APIs you need. Check and update the organisation's contact person and technical contact persons for certificates.

If the API is already in use, proceed directly to step 3. Request a certificate.

If the organisation is not using any APIs at this stage, select ‘Submit API application’.

• Select the APIs the organisation needs.
  • You can request access rights to several APIs at the same time, and the requested APIs can be provided by different parties. For example, you can select the Tax Administration’s Vero API and the Incomes Register’s API for reporting earnings payment data.
  • If you are requesting access rights to an Incomes Register API, also indicate why you want to use the API – whether you want to report income you have paid or whether you want to report data on behalf of someone else.
  • If you are requesting access rights to the Incomes Register’s API for reporting benefits payment data, also tick the confirmation that your organisation will start using the functions for reporting benefits payment data.
• Enter information about your organisation’s contact person.
  • The certificate’s technical contact person must be entered separately in each certificate request.
• Read the terms of use of API services.
• Finally, submit your application.

You can request a certificate immediately after you have submitted your application. In general, we recommend that you order a separate certificate for each API. However, you can use the same Web service certificate for data provider, reporter, and notifier in the Tax Administration’s APIs and the Incomes Register’s WS interface. 

If the organisation is already using an API but you want to start using a new API, select ‘Show information’ and then ‘Submit replacement application’.

If your organisation is a data user in the Incomes Register, you need a data permission to use the API. This is why you cannot submit an API application in the certificate service. Read the instructions for data permissions on the Incomes Register’s website.

Select the API for which you want to request a certificate.

• You can enter a brief description for the certificate.
• Enter a technical contact person for the certificate, such as a representative of the software company.
  • The contact person is responsible for the use of the certificate and will receive separate instructions to retrieve the certificate.
  • The contact person will receive a notification of an expiring certificate 60 days before it expires.
• Finally, submit your application.

Once you have submitted your certificate request, the technical contact person named in the request will receive the information required to retrieve the certificate.

After this, the certificate is available for retrieval for 14 days.

Read more detailed instructions for retrieving a certificate

If you want to change existing access rights or request access to additional Tax Administration or Incomes Register APIs for your organisation, sign in to the ‘Production certificates’ section again and submit a replacement API application.

The replacement application will replace all your previous selections, so make sure to enter all the APIs used by your organisation in it.

Complete the replacement application as you did the first one. Do not remove any selections already made in the application if your organisation is still using the selected APIs. If you are no longer using the previously selected APIs, you can remove the selections. In this case, the access rights to the APIs will also end.