---
title: "Get a navigation tree"
method: GET
path: "/v1/navigation/trees/{navigationTreeId}"
tags: ["navigation"]
---

# Get a navigation tree

`GET /v1/navigation/trees/{navigationTreeId}`

Get navigation tree by navigationTreeId, for example, `/v1/navigation/trees/123`.

## Path parameters

- `navigationTreeId` integer, required

## Query parameters

- `locale` string
- `with` string[]

## Response `200`

request successful

- NavigationTree
  - `id` integer, required
  - `key` string, required
  - `name` string, required
  - `items` NavigationItem[], required
    - `id` integer, required
    - `assets` object, required
    - `name` string, required
    - `type` string, required
    - `visibleFrom` string, nullable, required
    - `visibleTo` string, nullable, required
    - `options` object
      - `url` string
      - `isOpenInNewWindow` boolean
    - `extraFilters` NavigationItemExtraFilter
      - `attributes` object[], required
        - `attribute` object, required
          - `id` integer, required
          - `key` string, required
          - `label` string, required
          - `type` string, required
          - `multiSelect` boolean, required
        - `include` integer[], required
    - `category` Category
      - `id` integer, required — The unique identifier of the category.
      - `path` string, required — The slugs for all `rootlineIds` combined with `/` (e.g., `/women/fashion`).
      - `name` string, required — The name of the category
      - `slug` string, required — A short string to describe the current category (usable, for example, in URLs as).
      - `parentId` integer, required — The parent category ID (root-level categories have a parent ID of `0`)
      - `rootlineIds` integer[], required — The IDs for the path from the topmost root category to the current category, which is included as the last item.
      - `childrenIds` integer[], required — The child category IDs attached to the current category
      - `properties` CategoryProperty[], required — Properties attached to this category.
        - `name` string, required
        - `value` union, required
          - string
          - number
      - `isHidden` boolean, required — A flag that defines if a category should be displayed by the frontend
      - `depth` integer, required — The nesting level of the category (root-level depth = 1, child nodes = 2, child nodes' children = 3, etc.)
      - `supportedFilter` string[], required — A list of filters that can be used for filtering products in the category
      - `parent` Category — recursive
      - `shopLevelCustomData` object, required — Additional category data defined on the shop level
      - `countryLevelCustomData` object — Additional category data defined on the country level
      - `children` Category[] — An array of child category objects. Returned if requested as `tree format` or using `with`.
    - `children` NavigationItem[], required
    - `customData` object, required

## Other responses

- `400` — required query parameter missing / invalid
- `401` — authentication failed
- `404` — navigation tree not found

## Changes

- **2026-07-17** `8cfa924ae703` — 2 breaking, 1 warning, 28 info
  - the response property `items/items/visibleFrom` became nullable for the status `200`
  - the response property `items/items/visibleTo` became nullable for the status `200`
  - removed the optional property `items/items/extraFilters/atrributes` from the response with the `200` status
  - added the optional property `items/items/category/children` to the response with the `200` status
  - …27 more
- **2023-08-21** `beabe2149947` — 1 breaking
  - the `items/items/assets` response's property type/format changed from `array`/`` to `object`/`` for status `200`
- **2023-08-06** `302b7c443b51` — 26 breaking, 3 warning, 1 info
  - the response property `id` became optional for the status `200`
  - the response property `items` became optional for the status `200`
  - the response property `items/items/assets` became optional for the status `200`
  - the response property `items/items/children` became optional for the status `200`
  - …26 more

[Change history](https://skmtc.dev/scayle/apis/storefront-api-documentation/changes/v1/navigation/trees/:navigationTreeId/get.md)

---

[API](https://skmtc.dev/scayle/apis/storefront-api-documentation.md) · [All operations](https://skmtc.dev/scayle/apis/storefront-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/scayle/storefront-api-documentation/revisions/8cfa924ae703/schema)