---
title: "Get a single building."
method: GET
path: "/buildings/{buildingId}"
---

# Get a single building.

`GET /buildings/{buildingId}`

## Request

- Base URL: `https://people.utwente.nl/peoplepagesopenapi`
- URL: `https://people.utwente.nl/peoplepagesopenapi/buildings/{buildingId}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/utwente/apis/people-pages-api/docs/buildings/:buildingId/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns HTTP error code **404** if the specified building ID does not exist.

## Response `200`

A list of buildings

- BuildingsGetResponse
  - `found` integer, required: The number of buildings found.
  - `data` Building[], required: Building schema
    - `buildingId` string, required: Building ID.
    - `name` string, required: The name of the building.
    - `latitude` number: The latitude of the main entrance of the building.
    - `longitude` number: The longitude of the main entrance of the building.
  - `pageSize` integer: The maximum number of results.
  - `pageStart` integer: The row to start from (0 index based - i.e. 0 is the first row).

## Other responses

- `401`: Authentication is required
- `403`: Access to this resource has been denied
- `404`: The requested resource does not exist

---

[API](https://skmtc.dev/utwente/apis/people-pages-api.md) - [All operations](https://skmtc.dev/utwente/apis/people-pages-api/llms.txt) - [OpenAPI document](https://skmtc.dev/utwente/apis/people-pages-api/revisions/2a8c01eae6b0?raw)