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

# List hierarchies

`GET /corporate/v1/hierarchies`

## Request

- Base URL: `https://sandbox.pismolabs.io`
- URL: `https://sandbox.pismolabs.io/corporate/v1/hierarchies`
- Auth: HTTP bearer

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
    - `levels` Level[]: List of hierarchy levels
      - `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: Data related to list pagination using a cursor.
    - `limit` integer: Maximum number of items per page
    - `cursor` string: Cursor pointing to the next page of results

## Other responses

- `400`: A Bad Request validation error
- `401`: Access token is missing or invalid
- `403`: The request has been lost
- `404`: The specified resource was not found
- `500`: Internal Server Error

---

[API](https://skmtc.dev/pismo/apis/banking-transaction-banking.md) - [All operations](https://skmtc.dev/pismo/apis/banking-transaction-banking/llms.txt) - [OpenAPI document](https://skmtc.dev/pismo/apis/banking-transaction-banking/revisions/1334306c9303?raw)