# Suomi.fi Connection API

**Canonical:** https://apis.io/apis/suomi-fi/suomi-fi-connection-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 Connection 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 Connection. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a changelog, authentication docs, and 1 JSON Schema.

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 multiple channels and same channel can be used for accessing multiple services. The channels that have `allowedConnectionType` set to `AllOrganizations` can be connected to any organizations' services.

## Operations (3)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v12/connection/{serviceContentId}/{serviceChannelContentId}` | By service and channel content id:s |
| GET | `/api/v12/connection/search` | Search Connections |
| GET | `/api/v12/connection/archived` | Get archived connections |

## Machine-readable artifacts (6)

- **OpenAPI** — https://artifacts.apis.io/suomi-fi/openapi/suomi-fi-connection-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-connection-response-schema.json
- **APIsJSON** — https://artifacts.apis.io/suomi-fi/apis.yml

## Other Suomi.fi APIs (12)

- [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/)
- [Suomi.fi Service API](https://apis.io/apis/suomi-fi/suomi-fi-service-api/)

## Tags

Connection

---

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