How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

HY Organisation API

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.

HY Organisation API is one of 26 APIs that University of Helsinki publishes on the 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.

This API exposes 22 operations across 22 paths, and defines 19 schemas. It is described by OpenAPI 3.0.3, at version 1.0.0.

Requests are made against a single base URL, https://gw.api.helsinki.fi/organisation/info.

22 operations 22 paths 19 schemas 22 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
1.0.0
Base URL
https://gw.api.helsinki.fi/organisation
Authentication
API Key
Resource Areas
1

Authentication & Security 1

HY Organisation API declares 1 security scheme for authenticating requests. An API key is passed in the header as X-Api-Key (apiKey). By default, every request must be authenticated.

  • apiKey — APIKey Auth

Paths & Operations 22

Across 22 paths, the API surfaces 22 operations — 22 GET. Each is listed below with its method, path, parameters, and response codes.

Operations 22
GET
/v1/steeringGroups
GET v1/steeringGroups
getSteeringGroups → 200
GET
/v1/humanResources
GET v1/humanResources
getHumanResources → 200
GET
/v1/humanResourcesIamGroupPrefix
GET v1/humanResourcesIamGroupPrefix
getHumanResourcesIamGroupPrefix → 200
GET
/v1/researchResources
GET v1/researchResources
getResearchResources → 200
GET
/v1/researchGroups
Fetch nodes in 'tutkimusryhmat' hierarchy
getResearchGroups → 200
GET
/v1/financeUnits
GET v1/financeUnits
getFinanceUnits → 200
GET
/v2/financeUnits
GET v2/financeUnits
getFinanceUnitsWithPublicCode → 200
GET
/v1/financeUnitsPublic
GET v1/financeUnitsPublic
getFinanceUnitsPublic → 200
GET
/v1/financeUnitsUniqueCode
GET v1/financeUnits having uniquecode = "kylla"
getFinanceUnitsWithPublicCodeExclusive → 200
GET
/v1/educationUnits
GET v1/educationUnits
getEducationUnits → 200
GET
/v2/educationUnits
GET v2/educationUnits
getEducationUnitsV2 → 200
GET
/v1/officialUnits
GET v1/officialUnits
getOfficialUnits → 200
GET
/v2/officialUnits
GET v2/officialUnits
getOfficialUnitsV2 → 200
GET
/v1/UniversityOfHelsinkiGroup
GET University of Helsinki Group
getConcernGroups → 200
GET
/v1/NodesInMultipleHierarchies
Fetch nodes in given public hierarchies.
getNodesInMultipleHierarchies 1 param → 200403
GET
/v1/FinanceAndOldResearch
Fetch nodes in 'talous' and 'vanhayksikko' hierarchies that have certain attributes
getFinanceAndOldResearch → 200
GET
/v1/humanResourcesSubunitToUnit
Fetch certain units in human resources with their greatest parent
getHumanResourcesSubunitToUnit → 200
GET
/v1/humanResourcesWithLevel
Fetch units in human resources and their level on the tree
getHumanResourcesWithLevel 1 param → 200
GET
/v1/UniversityOfHelsinkiSubunitToUnit
Fetch certain units in konserni with their greatest parent
getUniversityOfHelsinkiSubunitToUnit → 200
GET
/v1/AllNodeAttributes
Fetch all nodes' attributes
getAllNodeAttributes → 200
GET
/v1/AllSuccessorsAndPredecessors
Fetch all successors and predecessors
getAllSuccessorsAndPredecessors → 200
GET
/v1/humanResourcesAndResearchGroups
Fetch nodes in 'tutkimusryhmat' and 'henkilosto' hierarchy
getHumanResourcesAndResearchGroups → 200

Schemas 19

The contract defines 19 schemas that model the data the API accepts and returns. The most detailed are FinanceAndOldResearch (11 properties), EducationUnitV2 (9 properties), EducationUnit (8 properties), HumanResourcesIamGroupPrefix (8 properties). Each schema is shown below with its type and property counts.

SteeringGroup
object
7 properties
HumanResourcesIamGroupPrefix
object
8 properties
HumanResourcesWithLevel
object
8 properties
FinanceUnit
object
7 properties
FinanceUnitWithUniqueCode
object
8 properties
PublicFinanceUnit
object
7 properties
OfficialUnit
object
7 properties
OfficialUnitV2
object
8 properties
ResearchResource
object
7 properties
ResearchGroup
object
7 properties
PublicHierarchyNode
object
4 properties
EducationUnit
object
8 properties
EducationUnitV2
object
9 properties
FinanceAndOldResearch
object
11 properties
humanResourcesSubunitToUnit
object
3 properties
UniversityOfHelsinkiSubunitToUnit
object
3 properties
NodeAttribute
object
5 properties
AllSuccessorsAndPredecessors
object
4 properties
HumanResourcesAndResearchGroups
object
7 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

university-of-helsinki-hy-organisation-api-openapi.yml Raw ↑

Other APIs University of Helsinki publishes across the network.

University of Helsinki API Portal (Gravitee)
Contact Search API
Course pages CMS
Helsinki.fi content
HY Building API
ServiceAPI
EmployeeInformationAPI
PersonGroup
General Efecte API
Network registry API
Sovellussalkku API
Dawa Sync API
Where this information came from

This is an independent, third-party profile of HY Organisation API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.