# Suomi.fi Service API

**Canonical:** https://apis.io/apis/suomi-fi/suomi-fi-service-api/  
**Provider:** Suomi.fi — https://apis.io/providers/suomi-fi/  
**Base URL:** https://api-gw.palvelutietovaranto.suomi.fi  
**Documentation:** https://docs.palvelutietovaranto.suomi.fi/api-documentation/v12/

Suomi.fi Service API is one of 18 APIs that [Suomi.fi](https://apis.io/providers/suomi-fi/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 1 JSON Schema definition. Tagged areas include Services. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a changelog, authentication docs, and 1 JSON Schema.

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 obtain the service. Services are connected to service channels via [connections](#tag/connection).

## Operations (3)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v12/service/{contentId}` | By content id |
| GET | `/api/v12/service/search` | Search services |
| GET | `/api/v12/service/archived` | Get archived services |

## Machine-readable artifacts (5)

- **OpenAPI** — https://artifacts.apis.io/suomi-fi/openapi/suomi-fi-service-api-openapi.yml
- **Documentation** — https://kehittajille.suomi.fi/palvelut/palvelutietovaranto
- **ChangeLog** — https://kehittajille.suomi.fi/palvelut/palvelutietovaranto/rajapinta-ja-arkkitehtuuriuudistus/asiakastestiympariston-v12-rajapinnan-muutosloki
- **Authentication** — https://kehittajille.suomi.fi/palvelut/palvelutietovaranto/rajapinta-ja-arkkitehtuuriuudistus/api-avaimen-kayttoohje-ptv-rajapintaversio-12
- **JSONSchema** — https://artifacts.apis.io/suomi-fi/json-schema/suomi-fi-service-response-schema.json

## Other Suomi.fi APIs (12)

- [Suomi.fi Connection API](https://apis.io/apis/suomi-fi/suomi-fi-connection-api/)
- [Suomi.fi Countries API](https://apis.io/apis/suomi-fi/suomi-fi-countries-api/)
- [Suomi.fi General description API](https://apis.io/apis/suomi-fi/suomi-fi-general-description-api/)
- [Suomi.fi Health check API](https://apis.io/apis/suomi-fi/suomi-fi-health-check-api/)
- [Suomi.fi Industrial classes API](https://apis.io/apis/suomi-fi/suomi-fi-industrial-classes-api/)
- [Suomi.fi Languages API](https://apis.io/apis/suomi-fi/suomi-fi-languages-api/)
- [Suomi.fi Life events API](https://apis.io/apis/suomi-fi/suomi-fi-life-events-api/)
- [Suomi.fi Municipalities API](https://apis.io/apis/suomi-fi/suomi-fi-municipalities-api/)
- [Suomi.fi Ontology terms API](https://apis.io/apis/suomi-fi/suomi-fi-ontology-terms-api/)
- [Suomi.fi Organization API](https://apis.io/apis/suomi-fi/suomi-fi-organization-api/)
- [Suomi.fi Postal codes API](https://apis.io/apis/suomi-fi/suomi-fi-postal-codes-api/)
- [Suomi.fi Regions API](https://apis.io/apis/suomi-fi/suomi-fi-regions-api/)

## Tags

Services

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/suomi-fi/suomi-fi-service-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/suomi-fi/.