# Suomi.fi

**Canonical:** https://apis.io/providers/suomi-fi/  
**Website:** https://kehittajille.suomi.fi  
**APIs profiled:** 1

Suomi.fi is the Finnish public sector's shared digital services platform, run by the Digital and Population Data Services Agency (Digi- ja väestötietovirasto, DVV). Its developer site (Suomi.fi kehittäjille) documents shared services such as Suomi.fi identification (tunnistus), e-authorizations (valtuudet), messages (viestit), payments (maksut), maps (kartat), the Data Exchange Layer (palveluväylä, X-Road), open data (avoindata) and the Finnish Service Catalogue (palvelutietovaranto, PTV), whose version 12 REST API is published with an OpenAPI 3.1.1 document.

## Kin Score — 56.3 / 100 (strong)

Scored 2026-11-13 under rubric 0.28.0.

| Facet | Score |
|---|---|
| Discoverability | 76.8 |
| Contract Quality | 58.0 |
| Contract Governance | 22.0 |
| Operational Transparency | 28.6 |
| Developer Ergonomics | 64.3 |
| Access Clarity | 61.7 |

Regulatory layer — **Government & Public Sector**: 30.4 (matched via tags).

## Agent readiness — 34.0 (agent-ready)

| Dimension | Value |
|---|---|
| Spec Presence | yes |
| Agentic Access | derived |
| Reversibility Documented | na |
| MCP Server | no |
| Auth Clarity | bearer |
| Idempotency | na |
| Error Semantics | verified |
| OpenAPI Examples | no |
| Rate Limit Signal | documented |
| Event Surface Described | no |
| Agent Skills | no |
| Well Known Catalog | no |
| Consent Identity | no |
| Agent Card | no |
| Dry Run Mode | na |
| Delegated Identity | no |
| Protected Resource Metadata | no |
| Dynamic Client Registration | no |
| Agentic Commerce | no |
| Pagination Ratio | paginated |
| Operation Distinctiveness | distinct |
| MCP Tool Quality | na |

## Access

Freemium · Self-serve signup — onboarding: self-serve, pricing: freemium, trial: no (confidence: medium).

## APIs (18)

- **Suomi.fi Connection API** — Connection joins [service](#tag/service) and [service channel](#tag/service-channel) together with many to many relationship. This means that same service can be accessed via mu...
- **Suomi.fi Countries API** — Countries endpoints
- **Suomi.fi General description API** — A general description is a ready-made template intended as the basis for describing a [service](#tag/service). Using a general description reduces the amount of work needed to d...
- **Suomi.fi Health check API** — Health check endpoints
- **Suomi.fi Industrial classes API** — Industrial classes endpoints
- **Suomi.fi Languages API** — Languages endpoints
- **Suomi.fi Life events API** — Life events endpoints
- **Suomi.fi Municipalities API** — Municipalities endpoints
- **Suomi.fi Ontology terms API** — Ontology terms endpoints
- **Suomi.fi Organization API** — An organisation is used as background information explaining which organisation is responsible for a service or a service channel or for providing a service. Each [service](#tag...
- **Suomi.fi Postal codes API** — Postal codes endpoints
- **Suomi.fi Regions API** — Regions endpoints
- **Suomi.fi Service API** — The service is the central concept of PTV. The data of a service describes what kind of service the customer receives, for whom the service is intended and how the user can obta...
- **Suomi.fi Service channel API** — A service channel is a channel through which a customer can use a [service](#tag/service). A service channel is associated to a service via a [connection](#tag/connection). Ther...
- **Suomi.fi Service classes API** — Service classes endpoints
- **Suomi.fi Service collection API** — Service collections are used to group [services](#tag/service) and [service channels](#tag/service-channel) together to create thematic groups.
- **Suomi.fi Target groups API** — Target groups endpoints
- **Suomi.fi Wellbeing services counties API** — Wellbeing services counties endpoints

## Agentic access (1)

- **Suomi.fi Agentic Access** — 32 operations

## Security (3)

- **Suomi.fi Authentication** — apiKey · 2 schemes
- **Suomi.fi Domain Security** — TLSv1.3 · HSTS · DNSSEC · DMARC
- **Suomi.fi Vulnerability Disclosure** — security.txt · contact published

## Plans (1)

- **Suomi.fi Plans Pricing**

## Tags

Government, Finland, Public Sector, Digital Identity, Service Catalogue, Open Data, X-Road

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/providers/suomi-fi/). Scores are computed from the provider's own public artifacts under a published rubric.