---
title: "List hierarchies"
method: GET
path: "/corporate/v1/hierarchies"
tags: ["Hierarchies"]
---

# List hierarchies

`GET /corporate/v1/hierarchies`

Lists hierarchies and their levels.

## Query parameters

- `cursor` string
- `limit` integer

## Response `200`

OK

- GetHierarchiesResponse
  - `hierarchies` object[], required — List of hierarchies data
    - `id` string, uuid, required — Hierarchy ID generated by the [Create hierarchy](https://developers.pismo.io/pismo-docs/reference/post-hierarchies) endpoint.
    - `name` string — Hierarchy name
    - `level` Level — Hierarchy level information
      - `id` string, uuid, required — Level ID generated by the [Create hierarchy](https://developers.pismo.io/pismo-docs/reference/post-hierarchies) endpoint.
      - `index` integer, required — Hierarchy level index
      - `name` string, required — Hierarchy level name
      - `description` string, required — Hierarchy level description
  - `pagination` Pagination, required
    - `next_cursor` integer, nullable — Cursor to get the next page
    - `has_next` boolean — Are more pages available?

## Other responses

- `400` — A Bad Request validation error
- `401` — Access token is missing or invalid
- `403` — The request has been lost
- `404` — Not Found
- `500` — Internal server error

---

[API](https://skmtc.dev/pismo/apis/platform-authentication.md) · [All operations](https://skmtc.dev/pismo/apis/platform-authentication/llms.txt) · [OpenAPI document](https://skmtc.dev/pismo/apis/platform-authentication/revisions/935b62e16de4?raw)