Suomi.fi for Service Developers
Go directly to contents.
Best practices for developers
API design in public administration

Publish the data model and source code openly

Public administration has significant influence

Public administration can significantly influence the productivity of society as a whole and the reuse of data.

When public administration creates open and reusable data models, vocabularies and code sets, this allows the companies and communities using them to make savings.

Updated: 5/5/2026

From open publication to a widely-used standard

When a data model is published under an open licence, it can develop into an industry standard. Statistics indicate that few companies create openly accessible or freely reusable personal data models, vocabularies and code sets.

Updated: 5/5/2026

Co-develop the data model

In an ideal situation, the data model (including code sets and vocabularies) is published to stakeholders for commenting before coding starts. Ideally, they have been co-developed with stakeholders.

Co-creation is particularly important in case of APIs intended for external use.

Updated: 5/5/2026

Are you satisfied with the content on this page?

Glossary