# Suomi.fi Organization API

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

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/service) and [service channel](#tag/service-channel) belongs to an organization.

## Operations (4)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v12/organization/{contentId}` | By content id |
| GET | `/api/v12/organization/search` | Search organizations |
| GET | `/api/v12/organization/hierarchy/{contentId}` | Get organization hierarchy tree |
| GET | `/api/v12/organization/archived` | Get archived organizations |

## Machine-readable artifacts (5)

- **OpenAPI** — https://artifacts.apis.io/suomi-fi/openapi/suomi-fi-organization-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-organization-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 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

Organization

---

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