# HY Organisation API

**Canonical:** https://apis.io/apis/university-of-helsinki/hy-organisation/  
**Provider:** University of Helsinki — https://apis.io/providers/university-of-helsinki/  
**Base URL:** https://gw.api.helsinki.fi/organisation  
**Documentation:** https://api.helsinki.fi/portal/

HY Organisation API is one of 26 APIs that [University of Helsinki](https://apis.io/providers/university-of-helsinki/) 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 Organisation, Registry, Hierarchy, and Reference Data. The published artifact set on APIs.io includes an OpenAPI specification and 1 JSON Schema.

Organisation Registry Public API — the University's organisational units and their hierarchy. The largest gateway contract: 22 paths and 19 component schemas, OpenAPI 3.0.3, X-Api-Key.

## Operations (22)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/steeringGroups` | GET v1/steeringGroups |
| GET | `/v1/humanResources` | GET v1/humanResources |
| GET | `/v1/humanResourcesIamGroupPrefix` | GET v1/humanResourcesIamGroupPrefix |
| GET | `/v1/researchResources` | GET v1/researchResources |
| GET | `/v1/researchGroups` | Fetch nodes in 'tutkimusryhmat' hierarchy |
| GET | `/v1/financeUnits` | GET v1/financeUnits |
| GET | `/v2/financeUnits` | GET v2/financeUnits |
| GET | `/v1/financeUnitsPublic` | GET v1/financeUnitsPublic |
| GET | `/v1/financeUnitsUniqueCode` | GET v1/financeUnits having unique_code = "kylla" |
| GET | `/v1/educationUnits` | GET v1/educationUnits |
| GET | `/v2/educationUnits` | GET v2/educationUnits |
| GET | `/v1/officialUnits` | GET v1/officialUnits |
| GET | `/v2/officialUnits` | GET v2/officialUnits |
| GET | `/v1/UniversityOfHelsinkiGroup` | GET University of Helsinki Group |
| GET | `/v1/NodesInMultipleHierarchies` | Fetch nodes in given public hierarchies. |
| GET | `/v1/FinanceAndOldResearch` | Fetch nodes in 'talous' and 'vanha_yksikko' hierarchies that have certain attributes |
| GET | `/v1/humanResourcesSubunitToUnit` | Fetch certain units in human resources with their greatest parent |
| GET | `/v1/humanResourcesWithLevel` | Fetch units in human resources and their level on the tree |
| GET | `/v1/UniversityOfHelsinkiSubunitToUnit` | Fetch certain units in konserni with their greatest parent |
| GET | `/v1/AllNodeAttributes` | Fetch all nodes' attributes |
| GET | `/v1/AllSuccessorsAndPredecessors` | Fetch all successors and predecessors |
| GET | `/v1/humanResourcesAndResearchGroups` | Fetch nodes in 'tutkimusryhmat' and 'henkilosto' hierarchy |

## Machine-readable artifacts (3)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/university-of-helsinki/refs/heads/main/openapi/university-of-helsinki-hy-organisation-api-openapi.yml
- **DeveloperPortal** — https://api.helsinki.fi/portal/
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/university-of-helsinki/refs/heads/main/json-schema/university-of-helsinki-hy-organisation-api-schemas.json

## Other University of Helsinki APIs (12)

- [University of Helsinki API Portal (Gravitee)](https://apis.io/apis/university-of-helsinki/api-gateway/)
- [Contact Search API](https://apis.io/apis/university-of-helsinki/contact-search/)
- [Course pages CMS](https://apis.io/apis/university-of-helsinki/course-pages-cms/)
- [Helsinki.fi content](https://apis.io/apis/university-of-helsinki/helsinki-fi-content/)
- [HY Building API](https://apis.io/apis/university-of-helsinki/hy-building/)
- [ServiceAPI](https://apis.io/apis/university-of-helsinki/serviceapi/)
- [EmployeeInformationAPI](https://apis.io/apis/university-of-helsinki/employeeinformation/)
- [PersonGroup](https://apis.io/apis/university-of-helsinki/persongroup/)
- [General Efecte API](https://apis.io/apis/university-of-helsinki/general-efecte/)
- [Network registry API](https://apis.io/apis/university-of-helsinki/network-registry/)
- [Sovellussalkku API](https://apis.io/apis/university-of-helsinki/sovellussalkku/)
- [Dawa Sync API](https://apis.io/apis/university-of-helsinki/dawa-sync/)

## Tags

Organisation, Registry, Hierarchy, Reference Data

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/university-of-helsinki/hy-organisation/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/university-of-helsinki/.