# Contact Search API

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

Contact Search 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 Search, Directory, Experts, and Personal Data. The published artifact set on APIs.io includes an OpenAPI specification and 1 JSON Schema.

Expert and contact search, used by the public helsinki.fi pages and the Flamma intranet. OpenAPI 3.1.0, 22 paths, 33 schemas — the only 3.1 document in the estate. Returns records about identifiable staff, so no live response is captured anywhere in this repository and no agent skill or MCP tool is emitted for it.

## Operations (23)

| Method | Path | Summary |
|---|---|---|
| GET | `/company_contacts` | Retrieves the collection of CompanyContact resources. |
| GET | `/company_contacts/{id}` | Retrieves a CompanyContact resource. |
| GET | `/company_organizations` | Retrieves the collection of CompanyOrganization resources. |
| GET | `/company_organizations/{id}` | Retrieves a CompanyOrganization resource. |
| GET | `/company_organizations/{id}/members` | Retrieves the collection of Company contact resources belonging to the Company organization |
| GET | `/company_titles` | Retrieves the collection of CompanyTitle resources. |
| GET | `/contacts` | Retrieves the collection of Contact resources. |
| GET | `/contacts/{id}` | Retrieves a Contact resource. |
| PUT | `/contacts/{id}` | Replaces the Contact resource. |
| GET | `/field_of_sciences` | Retrieves the collection of FieldOfScience resources. |
| GET | `/filters` | Retrieves the collection of Filter resources. |
| GET | `/filters/{id}` | Retrieves a Filter resource. |
| GET | `/hr_organizations` | Retrieves the collection of HrOrganization resources. |
| GET | `/hr_organizations/{id}` | Retrieves a HrOrganization resource. |
| GET | `/hr_organizations/{id}/members` | Retrieves the collection of Contact resources belonging to the HR organization |
| GET | `/organizations` | Retrieves the collection of Organization resources. |
| GET | `/organizations/{id}` | Retrieves a Organization resource. |
| GET | `/research_organizations` | Retrieves the collection of ResearchOrganization resources. |
| GET | `/steering_groups` | Retrieves the collection of SteeringGroup resources. |
| GET | `/steering_groups/{id}` | Retrieves a SteeringGroup resource. |
| GET | `/steering_groups/{id}/members` | Retrieves a SteeringGroupMember resources. |
| GET | `/suggestions` | Retrieves the collection of Suggestion resources. |
| GET | `/titles` | Retrieves the collection of Title resources. |

## Machine-readable artifacts (3)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/university-of-helsinki/refs/heads/main/openapi/university-of-helsinki-contact-search-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-contact-search-api-schemas.json

## Other University of Helsinki APIs (12)

- [University of Helsinki API Portal (Gravitee)](https://apis.io/apis/university-of-helsinki/api-gateway/)
- [HY Organisation API](https://apis.io/apis/university-of-helsinki/hy-organisation/)
- [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

Search, Directory, Experts, Personal Data

---

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