---
title: "Get a list of all buildings."
method: GET
path: "/buildings"
---

# Get a list of all buildings.

`GET /buildings`

## Request

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

Example 1. Get all buildings:<br>
[https://people.utwente.nl/peoplepagesopenapi/buildings](https://people.utwente.nl/peoplepagesopenapi/buildings)

Example 2. Find all buildings starting with "Hor", restrict to max 10 results:<br>
[https://people.utwente.nl/peoplepagesopenapi/buildings?name=hor*&order=name_asc&pageSize=10](https://people.utwente.nl/peoplepagesopenapi/buildings?name=hor*&order=name_asc&pageSize=10)

## 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

---

[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)