Scam messages have been sent out in the Tax Administration’s name. Read more about scams.

Acting on behalf of other organizations with Vero API interfaces

Vero API interfaces allows the user to submit or retrieve data on behalf of their own organization or on behalf of another organization as an authorized representative. If the interface user is acting on behalf of their own organization, a separate Suomi.fi authorization is not required to use the interfaces. However, if the interface user is acting on behalf of another organization, the user may need a Suomi.fi authorization. If a Suomi.fi authorization is required, it is always explained separately in the documentation of the interface in the API portal.

Vero API interfaces use Suomi.fi authorization service provided by the Digital and population data services agency (DVV). Using the authorization service individuals and companies can authorize other individuals or companies to act on their behalf in various administrative matters, such as managing tax affairs. Suomi.fi authorizations can be granted or requested through the Suomi.fi service. For more information about authorizations and how to grant them can be found in here: How to grant a Suomi.fi authorisation for tax matters.

Below are use case examples of how an user can act either on behalf of their own organization or as an authorized representative on behalf of another organization.

Example 1: An accounting office is using an accounting and payroll software, which has an integration built for the List letters request API interface. The accounting office is using the interface to manage their own tax affairs and it uses the interface to request only letters which have been sent for the accounting office itself by the Tax administration. In this case the accounting office is acting on behalf of its’ own organization and it does not manage other organizations tax affairs with this interface. This means that no letters are being request on behalf of other organizations and the accounting office does not need a Suomi.fi authorization to use the interface.

Example 2: An accounting office is using an accounting and payroll software, which has an integration built for the List letters request API interface. The accounting office is managing other companies’ tax and accounting affairs and it is using the interface as a part of this business activity. The accounting office is using the interface to request their business clients’ letters which have been sent by the Tax administration. After retrieving the letters, the accounting office can react to them appropriately. In this case the accounting office is acting on behalf of other organizations and a valid Suomi.fi authorization is required to use the interface.

Suomi.fi authorizations are required in the following Vero API interfaces currently:

  • Decision and letters interfaces
  • Role registration update
  • Line of Business and Accounting Period Query
  • Tax period inquiry
  • Balance specification
  • Transaction search
  • Car tax decision interfaces and return status inquiry
  • EMCS interfaces
  • Excise duties
  • Household expenses reporting interfaces
  • Pensions and benefits reporting and Pensions and benefits changed withholding data inquiry
  • Value added tax and VAT EC sales interfaces
  • Corporate income tax interfaces (prepayment interfaces, send profit distribution, share values inquiry)
Page last updated 10/7/2025