API and architecture reform

The Digital and Population Data Services Agency is reforming the architecture of the FSC. The reform clarifies and simplifies the technical implementation of the FSC, makes the APIs easier to use and implements many development proposals received from customers over the years.

The reform does not involve changing the FSC data model except for a few additional fields.

Recordings of information events related to the architecture reform (in Finnish)Opens in a new window..

All integration customers using the OUT or IN API must switch to API version 12 by April 2027, the latest. This requires measures from all integration customers.

Timetable

01/2026

• Version 12 search API (OUT interface) methods have been published in the Customer Test Environment (formerly the training environment) and are now available for testing.
• The current data in the Customer Test Environment is available, and additional content can be created within existing organisations.
• All different content types can be retrieved, for example, it is possible to create a complete set combining a service and its service channels.
• Version 11 OUT and IN interfaces are still available.

03–04/2026

• The new version 12 search API (OUT) methods have been published in the Production Environment as a beta. Changes may still occur in production before autumn 2026.
• All data can be retrieved from the Production Environment, API key is in use.
• Version 11 OUT and IN interfaces are still available.

Autumn 2026 / To be specified

• The new version 12 import API (IN interface) methods will be released in the Customer Test Environment and will be available for testing.
• Version 11 OUT and IN interfaces are still available.

Autumn 2026 / To be specified

• The final versions of the version 12 search API (OUT) methods will be released in the Production Environment, and no breaking changes will be made after that.
• Version 11 OUT and IN interfaces are still available.

April 2027 / To be specified

• Version 12 import API (IN) methods will be published in the Production Environment. All import API users switch to version 12 at the same time.
• V11 interfaces (OUT and IN) are disabled in April 2027.
• The user interface switches to the UI interfaces of the new application.

New features planned for API version 12

Key improvements and changes