# Aalto Facilities API

**Canonical:** https://apis.io/apis/aalto/facilities/  
**Provider:** Aalto University — https://apis.io/providers/aalto/  
**Base URL:** https://facilities.api.aalto.fi/api/aalto  
**Documentation:** https://3scale.apps.ocp4.aalto.fi/docs/swagger/facilities2

Aalto Facilities API is one of 13 APIs that [Aalto University](https://apis.io/providers/aalto/) 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 Facilities, Buildings, Room Booking, Campus, and Reservations. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 1 JSON Schema.

Buildings, building details, opening hours, rooms and room reservations across Aalto's Espoo campus. OpenAPI 3.0.1, version 1.0.2, contact it-integ@aalto.fi, served from facilities.api.aalto.fi. Documented on the portal as "Facilities API : Buildings and Reservations". The contract declares no securityScheme, but the gateway rejects an anonymous call with 403 — a real gap between the documented and deployed auth surface.

## Operations (5)

| Method | Path | Summary |
|---|---|---|
| GET | `/facilities/v1/buildings/{code}` | Find building information by id |
| GET | `/facilities/v1/buildings` | Retreive information about all buildings |
| GET | `/facilities/v1/building` | Retrieve detailed building information |
| GET | `/reservations/v1/reservations/{id}` | Find a reservation by id |
| GET | `/reservations/v1/reservations` | Return all of the reservations |

## Machine-readable artifacts (3)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/aalto/refs/heads/main/openapi/aalto-facilities-api-openapi.yml
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/aalto/refs/heads/main/json-schema/aalto-facilities-api-schema.json
- **Documentation** — https://3scale.apps.ocp4.aalto.fi/docs/swagger/facilities2

## Other Aalto University APIs (12)

- [Aalto API Gateway](https://apis.io/apis/aalto/api-gateway/)
- [Aalto Course API (SISU)](https://apis.io/apis/aalto/course-sisu/)
- [Aalto Research Publications API (Acris gateway)](https://apis.io/apis/aalto/acris-research/)
- [Aalto Projects and Cost Centers API](https://apis.io/apis/aalto/projects-costcenters/)
- [Aalto People Profile API](https://apis.io/apis/aalto/people-profile/)
- [Aalto Open API — Course API (Oodi, deprecated)](https://apis.io/apis/aalto/course-oodi-deprecated/)
- [Aaltodoc Repository — OAI-PMH and DSpace REST](https://apis.io/apis/aalto/aaltodoc/)
- [Aalto Shibboleth Identity Provider (Haka / eduGAIN)](https://apis.io/apis/aalto/identity-federation/)
- [Linked Open Aalto Data (SPARQL)](https://apis.io/apis/aalto/linked-open-data/)
- [Acris — Aalto Current Research Information System (Elsevier Pure)](https://apis.io/apis/aalto/acris-pure/)
- [Aalto Learning Centre discovery (Ex Libris Primo / Alma, Finna)](https://apis.io/apis/aalto/library-discovery/)
- [SISU student information system (Funidata)](https://apis.io/apis/aalto/sisu-sis/)

## Tags

Facilities, Buildings, Room Booking, Campus, Reservations

---

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