Testing the Suomi.fi Finnish Service Catalogue version 12 search API is now available in the Customer Test Environment

API version 12 (OUT API) of the Suomi.fi Finnish Service Catalogue is now available for testing using the Customer Test Environment. API version 12 is released for trialling in the Customer Test Environment (formerly known as the training environment).

The API methodology are available in Scalar: https://api.palvelutietovaranto.trn.suomi.fi/api/v12/documentation/Opens in a new window.

In the initial phase, an API key is not required for testing in the Customer Test Environment. The API key will be activated later in spring 2026, with separate notification.

Testing the version 12 IN interface is not possible; the IN interface methods will only be released in the Customer Test Environment in the autumn.

Content can be created for the client test environment

The version 12 search interface can be tested with data entered into the Customer Test Environment UI. For testing, the organisation or IT supplier can create and connect services and service channels for a chosen premade test organisation in the Customer Test Environment. Please note that there is an approximately one-hour delay in the Customer Test Environment data transferring to API version 12, and therefore data does not immediately appear in API version 12.

Log in to the Customer Test Environment UI at https://palvelutietovaranto.trn.suomi.fi/Opens in a new window..

The Customer Test Environment UI credentials are available in the Excel sheet on the page Additional information for implementers of the IN-integration. You can log in to the Customer Test Environment using the credentials of any organisation in the speadsheet.

Instructions available – any comments are appreciated

Material for supporting testing is available in the Suomi.fi for Service Developers website API and architecture reform:Uniform service descriptions – Suomi.fi for Service Developers and its subpages.

• Transition from API version 11 to 12
• Data model overview (in Finnish)
• Processing rules for the interpretation of API data (in Finnish)

The guidelines are still a draft, to be supplemented during 2026.

The search interfaces are now released for testing. We appreciate any feedback and comments on the test results and instructions. During the spring, the new API will further be tested by a few pilot organisations that report their observations to the Digital and Population Data Services Agency.

Please submit your comment on the instructions and new search interfaces to ptv-tuki@dvv.fi.

API reform training sessions will be scheduled for the spring for discussing any observations and queries. You will receive the training schedule by emailed soon.

Follow the API reform

The new API version 12 search interfaces (OUT interfaces) will be available as beta version in the Production Environment in March-April. Finished version 12 search interfaces will be released for production in autumn 2026, with no breaking changes in the future. Information on the release date will be provided by email throughout the year and on the Topical pageOpens in a new window. of the Suomi.fi for Developers website.

Information on the API reform will be provided via email

• to the admin of each organisations with an FSC deployment irrespective of whether the organisation has deployed the integration
• to the admin and IT provider agent of each organisation with the integration deployment.