---
title: "The containment ladder this collection's graph is read down"
method: GET
path: "/api/v0/knowledge-bases/{kb_id}/graph/hierarchy"
tags: ["Knowledge Base Graph"]
---

# The containment ladder this collection's graph is read down

`GET /api/v0/knowledge-bases/{kb_id}/graph/hierarchy`

## Request

- Base URL: `https://api.outerport.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.outerport.com/api/v0/knowledge-bases/{kb_id}/graph/hierarchy`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/outerport/apis/outerport-api/docs/api/v0/knowledge-bases/:kb_id/graph/hierarchy/get.ts> (a function with typed inputs; its response is checked against the schema)

The ordered rungs declared by the packages this collection subscribes to. Empty when no subscribed package declares one, which means the collection makes no containment claim and a client must not invent an ordering of its own.

## Path parameters

- `kb_id` string, uuid, required

## Response `200`

Successful Response

- HierarchyLevelResponse[]
  - `entity_type_id` string, required
  - `via_relationship_type_id` string, nullable
  - `via_points_up` boolean
  - `shadowed_by` string[]

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-13** `7f81908bcdfe`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/outerport/apis/outerport-api/changes/api/v0/knowledge-bases/:kb_id/graph/hierarchy/get.md)

---

[API](https://skmtc.dev/outerport/apis/outerport-api.md) - [All operations](https://skmtc.dev/outerport/apis/outerport-api/llms.txt) - [OpenAPI document](https://skmtc.dev/outerport/apis/outerport-api/revisions/08b5bf6f7f18?raw)