---
title: "H11 - List Catalog categories (parents and children) related to a Catalog category"
method: GET
path: "/api/hierarchies"
tags: ["Products"]
---

# H11 - List Catalog categories (parents and children) related to a Catalog category

`GET /api/hierarchies`

## Request

- Base URL: `https://your-instance.mirakl.net`
- URL: `https://your-instance.mirakl.net/api/hierarchies`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://auth.mirakl.net/authorize`
    - Token URL: `https://auth.mirakl.net/oauth/token`
- TypeScript: <https://skmtc.dev/mirakl/apis/mirakl-catalog-manager-apis/docs/api/hierarchies/get.ts> (a function with typed inputs; its response is checked against the schema)

<div class="api-description-extension">
<div class="extension-title">Call Frequency</div>

<div class="recommended-call-frequency">Recommended usage: Every hour</div>
<div class="max-call-frequency">Maximum usage: Every hour</div>
</div>

## Query parameters

- `hierarchy` string
- `max_level` integer

## Response `200`

OK

- H11Response200
  - `hierarchies` H11Response200Hierarchies[], required: List of hierarchies
    - `code` string, required: Hierarchy code
    - `label` string: Hierarchy label
    - `label_translations` H11Response200HierarchiesLabelTranslations[], required: Hierarchy label translation
      - `locale` string: Locale
      - `value` string: Translation
    - `level` integer, required: Hierarchy level
    - `parent_code` string, required: Parent Hierarchy code

---

[API](https://skmtc.dev/mirakl/apis/mirakl-catalog-manager-apis.md) - [All operations](https://skmtc.dev/mirakl/apis/mirakl-catalog-manager-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/mirakl/apis/mirakl-catalog-manager-apis/revisions/dd54ccb6550e?raw)