---
title: "List division"
method: GET
path: "/corporate/v2/divisions"
tags: ["Divisions"]
---

# List division

`GET /corporate/v2/divisions`

## Request

- Base URL: `https://sandbox.pismolabs.io`
- URL: `https://sandbox.pismolabs.io/corporate/v2/divisions`
- Auth: HTTP bearer

Lists divisions by hierarchy ID or level ID. Only one of the parameters should be provided with the request. Providing both generates an error.

## Query parameters

- `hierarchyId` string
- `levelId` string

## Response `200`

OK

- ListDivisionsResponseV2
  - `divisions` DivisionResponseV2[]: List of divisions
    - `division_id` string, uuid, required: The Pismo platform generates the division ID when you use the [Create division](ref:post-division-v2) endpoint. This ID is immutable and cannot be changed.
    - `division_code` string: Division code registered in the [Create division](https://developers.pismo.io/pismo-docs/reference/post-division-v2) endpoint.
    - `parent_code` string: Division code that can be set as the parent of the division being created. The parent must be at a level with a lower index than the division being created. It must comply with the rule `^[a-zA-Z0-9-]+$`.
    - `name` string: Division name
    - `description` string, nullable: Division description
    - `level_id` string, uuid: Level ID generated by the [Create hierarchy](https://developers.pismo.io/pismo-docs/reference/post-hierarchies) endpoint.
    - `hierarchy_id` string, uuid: Hierarchy ID generated by the [Create hierarchy](https://developers.pismo.io/pismo-docs/reference/post-hierarchies) endpoint.
    - `administrative_division_id` integer: Administrative division ID. Specifying an administrative division ID in this field links your division to it. This is useful when you want to use the holidays defined in that administrative division.<br> **NOTE**: `administrative_division_id` points to [holiday calendar](ref:post-add-holiday-to-calendar). Administrative division is deprecated and replaced by holiday calendar, and both continue to use the same underlying data structure for backward compatibility. The administrative division ID is functionally equivalent to `holiday_calendar_id` and refers to the calendar that defines holidays and working days. For more information, refer to [Add holiday](ref:post-add-holiday-to-calendar).
    - `program_ids` integer[]: List of allowed program IDs. The programs must belong to the organization. This list is used for validation during the [Create transaction banking account](ref:post-account) process. You can retrieve the organization programs using the [List programs](ref:programs-1) endpoint. If no program IDs are specified, this division inherits the `program_ids` list from the parent division, if it exists.
  - `pagination` Pagination: 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`: Bad Request

---

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