---
title: "getHierarchyDetailsV2"
method: GET
path: "/hierarchy/v2/getHierarchyDetails"
tags: ["Hierarchy Service"]
---

# getHierarchyDetailsV2

`GET /hierarchy/v2/getHierarchyDetails`

Retrieve the details of a specific hierarchy.

## Query parameters

- `hierarchyType` string, required
- `levelNumber` string
- `parentLogicalName` string
- `includeNull` boolean

## Headers

- `authenticationtoken` string, required
- `password` string
- `sitename` string, required
- `userid` string
- `X-B3-TraceId` string

## Response `200`

Success

- GetHierarchyV2DetailsResponse — GetHierarchyV2DetailsResponse description
  - `hierarchyType` string — "hierarchyType" from Hierarchy setup screen
  - `levels` HierarchyV2LevelDto[]
    - `levelDescription` string, required — "levelDescription" from Hierarchy setup screen.
    - `levelName` string, required — "levelName" from Hierarchy setup screen.
    - `levelNumber` integer, required — "levelNumber" from Hierarchy setup screen.
  - `locationCode` string — "locationCode" from Hierarchy setup screen
  - `locations` HierarchyDetailDto[]
    - `hasChildren` boolean — Indicates whether the hierarchy has more than just one level. Valid values are 'true' or 'false'.
    - `levelDescription` string, required — "Level Description" from Hierarchy setup screen.
    - `levelName` string, required — "Level Name" from Hierarchy setup screen.
    - `levelNumber` integer, required — "Nierarchy Level" number from Hierarchy setup screen.
    - `locationCode` string — "Code" for the physical location from Hierarchy setup screen.
    - `locationName` string — Name for the physical "Location" from Hierarchy setup screen.
    - `logicalName` string — Name for the logical "Location" from Hierarchy setup screen.
    - `parentLogicalName` string — Name of the "Parent Location" from Hierarchy setup screen.

## Other responses

- `400` — Validation Error
- `401` — Authorization
- `404` — Hierarchy Not Found
- `429` — Too Many Requests
- `500` — Unexpected Error
- `503` — System under maintenance
- `504` — Timeout

---

[API](https://skmtc.net/crunchtime/apis/inventory-labor.md) · [All operations](https://skmtc.net/crunchtime/apis/inventory-labor/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/crunchtime/inventory-labor/revisions/0af8e380ff2c/schema)