Use of Suomi.fi Messages will be transferred to the REST interface – see the transition periods!
In the next few years, the use of Suomi.fi Messages will move to the new REST interface. Through this new API, it is possible to access features that were previously in Suomi.fi Messages as features of different APIs. In the future, organisations using or activating the service will have no need to compare different APIs and assess which of them would be the best for the organisation’s needs. All features are found in one API.
The Digital and Population Data Services Agency has now set a schedule for discontinuing old connections. The new REST interface does not affect old APIs, and they continue to work alongside the new API. However, all new activations of Suomi.fi Messages will only be carried out through the REST API from now on.
Old APIs being phased out
From 1 January 2025, all new activations of Suomi.fi Messages will be carried out through the REST interface. New services can be added to existing connections until 31 December 2025. This applies especially to services that are connected to Suomi.fi Messages through off-the-shelf software provided by the ICT service provider used by the organisation.
All old APIs will be closed on 1 January 2027. This means that all services using Suomi.fi Messages must switch to the new REST interface before 2027.
New API offers more seamless use
The new REST interface facilitates the activation of Suomi.fi Messages features in organisations. Its maintenance is also more seamless, and any errors can be detected and repaired more quickly.
The transition to the new API can also be done in stages.
“If your organisation will soon be making changes to Suomi.fi Messages, we recommend adopting the new REST API right now. The transition can be made in a controlled manner one service or functionality at a time, in which case the modifications can be incremented over a longer period,” explains service owner Maria Juka-Lahdenperä from the Digital and Population Data Services Agency.
See the compiled schedules for transitioning from old connections to the REST interface:
| Starting 1 January 2025 | New connections will no longer be made to old APIs, e.g. new email connections will no longer open. |
| Starting 1 January 2026 | No more services will be added to old connections (especially software solutions offered by ICT service providers) |
| 1 January 2027 | The old APIs will be shut down. Each organisation using Suomi.fi Messages must be using the new REST interface. |
Additional information
Digital and Population Data Services Agency, customer service for organisations, tel. +358 (0)295 535 115 (phone service open Mon–Fri 10:00 a.m. – 3:00 p.m.), [email protected]
- Individuals
- Moving
- Check your own personal details
- Certificates from the Population Information System
- Names
- Guardianship
- Having or adopting a child
- Marriage
- Death and estate inventory
- Life changes while living abroad
- Moving while living abroad
- Registration of a child born abroad
- Marriage concluded abroad
- Partnership registered abroad
- Divorce granted abroad
- Registration of a name change performed abroad
- Death abroad
- Registration of citizenship
- Loss of citizenship of another country
- Notification of retaining Finnish citizenship
- Legalisation of foreign documents
- Submitting foreign documents
- As a foreigner in Finland
- Registration of a foreigner
- Guide for students
- Municipality of residence
- Family relationships and Marital Status
- Instructions on arriving in Finland from Ukraine
- Guide for employed persons
- Fast track service for specialists and growth entrepreneurs
- Instructions for legalisation
- Submitting foreign documents
- Foreigner’s move to Finland, in Finland and out of Finland
- Services of notary public
- Confirmation of gender
- Population information in the Population Information System
- Elections and Right to vote
- Certification of purchase
- Registration of a gift notification
- Citizen Certificate and electronic identity
- Organisations
- Certificates, cards, seals and stamps
- For social welfare and healthcare service providers
- For organisations
- Electronic sealing service
- Timestamping Service
- Electronic signature
- Service certificates
- Advisory service, support and revocation service
- Certificate Directory
- Test the use of a certificate
- Card Reader Software
- Information about certificates
- Population information services for organisations
- Public administration sampling and updating service
- Private sector information services
- PIS modified data interface
- Modified data update service
- Population Information System query interface
- Browser-based Population Information System query
- Resident selection service
- Selection service for municipalities
- Reform of personal identity code
- Conditions for using population information
- Selection service for wellbeing services counties
- Maintaining the Population Information System
- Extracts from registers
- Suomi.fi services
- Services to promote digitalisation
- Digital support
- Digital security services
- Services of notary public
- Certification of purchase
- Right to officiate weddings
- E-services
- Finnish Authenticator identification service
- Certificates, cards, seals and stamps
- About the agency
- Digital and Population Data Services Agency
- Digital and Population Data Services Agency as an Employer
- Use our services electronically
- News
- Contact
- Customer service for private customers
- Customer service for organisations
- Service locations
- Digital and Population Data Services Agency address, switchboard e-billing details
- Digital and Population Data Services Agency Management
- Marriage ceremony premises information
- Contact details for media
- International Affairs
- Invoicing
- Quality policy
- Equality plan for customers
- Data protection
- Population Information System
- For media
- Brochures and publications
- Projects
- Foresight and research cooperation