Vero API

Vero API is an integration service for real time interactions with Finnish Tax Administration. It provides easy integration to tax processes for software developers. The service follows API standards.

Vero API is aimed for platforms, software vendors and other service providers who do their own software development.  If you don't do your own software development, please contact your software vendor to request integration with these services.

The use of interfaces requires a user-specific certificate and a software-specific API key.

How do I get started?

The steps for implementing the Vero API interfaces are described in the guide "How to start using the interfaces." Please read the different steps and the related instructions carefully to ensure that the implementation of the interfaces is as smooth as possible.

Explore the Vero API interface family

Review the interfaces below and find out how their use could enhance the performance of your software.

Individual income tax

  • Household expenses reporting for employee wages
  • Household expenses reporting for companies
  • Pensions and benefits reporting
  • Pensions and benefits changed withholding data inquiry
  • Withholding percentage request
  • Rental income reporting
  • Liability status Inquiry

Sandbox Vero API portal

Car tax

  • Demonstration vehicle
  • Car tax new vehicles monthly decision
  • Car tax used vehicle decision
  • New vehicles monthly return
  • Price list filing
  • Used vehicles return
  • Get Vehicle-specific Return Status
  • Get Vehicle Information

Sandbox Vero API portal

Decisions and letters

  • Get letter
  • List info requests
  • List letters
  • Send info request response attachment file
  • Send info request text response

Sandbox Vero API portal

Roles

  • Role registration update
  • Role registration line of business and accounting period query
  • Role registration information inquiry
  • Tax period inquiry

Sandbox Vero API portal

IDs

  • Get invoice address
  • Payment reference inquiry
  • Register tax number
  • Send invoice address
  • Validate tax number

Sandbox Vero API portal

Self-assessed taxes

  • File VAT EC sales list
  • File VAT return
  • Get filed VAT return
  • Get VAT periods

Sandbox Vero API portal

Corporate income tax

  • Calculate CIT prepayment amount
  • Get current CIT prepayment info
  • Send CIT prepayment application
  • Send profit distribution
  • Share values inquiry

Sandbox Vero API portal

Excise Movement and Control System, EMCS

Businesses operating with products subject to excise duty and using EMCS can start submitting information on movement of products with this API.

Read more: EMCS interfaces will be transferred to the Vero API service.

 

Sandbox Vero API portal

Payment

  • Balance specification
  • Transaction search

Sandbox Vero API portal

Codes

  • Codes API

Sandbox Vero API portal

Authorization

  • Get Vero API Suomi.fi authorization token

Sandbox Vero API portal

Notification Service

  • End Notification Subscription
  • List Notifications
  • List Notification Subscriptions
  • Subscribe Notifications
  • Get Notification
  • Register Push

Sandbox Vero API portal

Excise duties

  • Send excise duty return on soft drinks
  • Send beverage containers duty return
  • Send excise duty return on alcohol
  • Send electricity excise duty return
  • Get filed excise duty return

Sandbox Vero API portal

Transfer tax

  • Transfer tax return filing

Vero API portal

Planned interfaces

In the sandbox you can find the current and planned interfaces. There you can review the preliminary descriptions of the data content of the new interfaces.  

Go to the sandbox (link opens in a new window)

Please note that no decisions have been made concerning the implementation of these planned interfaces. The data contents of the interfaces may change. 



Olet jo vastannut kyselyyn "Palautekysely verkkosivuilla", kiitos vastauksestasi!
Please respond to the required questions (*)
Please check text inputs
Page last updated 4/9/2025