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

# List division

`GET /corporate/v2/divisions`

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 — Pismo generates the division ID when you use the [Create division](https://developers.pismo.io/pismo-docs/reference/post-division-v2) endpoint.
    - `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.
    - `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](https://developers.pismo.io/pismo-docs/reference/post-account) process. You can retrieve the organization programs using the [List programs](https://developers.pismo.io/pismo-docs/reference/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
    - `next_cursor` integer, nullable — Cursor to get the next page
    - `has_next` boolean — Are more pages available?

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.dev/pismo/apis/platform-authentication.md) · [All operations](https://skmtc.dev/pismo/apis/platform-authentication/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pismo/platform-authentication/revisions/935b62e16de4/schema)