---
title: "Get a list of all organizational units (departments, clusters and sections)."
method: GET
path: "/organizations"
---

# Get a list of all organizational units (departments, clusters and sections).

`GET /organizations`

## Request

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

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

Example 2. Get all departments, ordered by name:<br>
[https://people.utwente.nl/peoplepagesopenapi/organizations?type=department&order=name_asc](https://people.utwente.nl/peoplepagesopenapi/organizations?type=department&order=name_asc)

Example 3. Get clusters and sections 11 - 20 of "TNW":<br>
[https://people.utwente.nl/peoplepagesopenapi/organizations?parentId=TNW&pageSize=10&pageStart=10](https://people.utwente.nl/peoplepagesopenapi/organizations?parentId=TNW&pageSize=10&pageStart=10)

## Response `200`

A list of organizations

- OrganizationsGetResponse
  - `found` integer, required: The number of organizations found.
  - `data` Organization[], required: Organization schema
    - `organizationId` string, required: Organization ID.
    - `name` string, required: The name of the organizational unit.
    - `type` 'department' | 'cluster' | 'section', required: The type of this organization unit.
    - `parentId` string: The parent of this organization unit.
  - `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)