Suomi.fi e-Authorizations


General description

Suomi.fi e-Authorizations is a service that enables an organisation to verify the mandates of a person or a company to act online on behalf of another person or a company they represent.

When verifying the mandates, the organisation's e-service enquiries the e-Authorizations service in order to determine whether the party is entitled to act on behalf of another party. The e-Authorizations service retrieves the data from the basic data registers and/or the authorisation register and returns the response in real time to the e-service.

Suomi.fi e-Authorizations is available for end users and customer organisations 24/7/365 without disruptions. New organisations can be connected to Suomi.fi e-Authorizations without it causing any harm to the customer organisations that have joined earlier.

The Digital and Population Data Services Agency is responsible for providing a scalable service solution in which increasing volumes do not affect the availability of the service. The service is available in Finnish, Swedish and English.

For more information about Suomi.fi e-Authorizations, visit Suomi.fi Service Management at: https://palveluhallinta.suomi.fi/fi/sivut/valtuudet/esittely

The limitations and prerequisites of the usage of the service

Public administration and private sector actors can connect to and use the e-Authorizations service free of charge. However, the customer organisation will bear all costs resulting from the implementation of the service. Those costs can result from the technical integration, changes in user interface, creating the transaction service specific instructions and administrating the implement project.

Service provider has to fill in the announcement for joining i.e. user permit application and accept the terms and conditions for Suomi.fi e-Authorizations before the implementation. Before using the e-Authorizations service, the organisation must have a strong identification service in use.

Service provider has to create a connection to e- Authorizations service either via Suomi.fi Data Exchange Layer or via Web API interface i.e. the public internet and add the possibility to act on behalf of another to its services. The end users must be introduced to the new operative process and the functionalities of the program.

Implementation of the service

Implementing the Suomi.fi e-Authorizations service requires that you connect to the e-Authorizations service interface. The connection can be made either via the Suomi.fi Data Exchange Layer (Security Server interface) or the public Internet (Web API).

The most suitable connection method for the e-service is selected on the basis of use cases. The customer organisation builds an interface in its information system in order to send a mandate check query and receive a response message.

To agree on the implementation, please contact Suomi.fi customer service: organisaatiopalvelut@dvv.fi

For more information on the implementation of the service, see Suomi.fi Service Management at: https://palveluhallinta.suomi.fi/fi/sivut/valtuudet/kayttoonotto/vaiheet


  • The Authorization interface is used to check whether the agent has the right to manage a specific matter on behalf of the principal.
  • The AuthorizationList interface is used to check which matters the agent has the right to act on behalf of the principal.
  • The OrganizationalMandates interface is used to check whether the company has the right to act on behalf of another company and in what types of matters.
  • The OrganizationalRoles interface is used to check whether a person has the right to act on behalf of a company and what kind of role they have in relation to the company.

Service bus identifier




Additional Info

Field Value
Maintainer Digi- ja väestötietovirasto
Maintainer Email organisaatiopalvelut@dvv.fi
Data Exchange Layer environment (X-Road instance) FI
Organisation type (X-Road member class) GOV
Organisation code (Business ID, X-Road member code) 0245437-2
Organisation code (Business ID, X-Road member code) RolesAuthsService