# Get navigation tree

**GET /navigation/trees/{tree_id}**

Returns the content of a given navigation tree.

A navigation tree is a tree-structure to organize your products and navigate into them in a classic "nested folders" architecture.

It is very different from the navigation guide whose structure is dynamic and depends on the population considered and the answers chosen previously.

The depth of the tree is not fixed, and can vary accross a given tree depending on the branches.

Some trees allow for products to be found in multiple nodes, whereas some others will enforce a unicity constraint. This is detailed via the `allow_multiple_nodes` attribute

For all the nodes with a `parent_node_id`, the API guarantees that the parent node is returned before any of its children in the list, allowing a single-pass parsing of the tree.



## Servers
- https://api.ppe-analytics.com/api/v1: https://api.ppe-analytics.com/api/v1 ()


## Authentication methods
- Api key


## Parameters

### Path parameters
- **tree_id** ()
  The navigation tree id, as returned by list navigation trees endpoint.

### Query parameters
- **max_depth** ()
  The max depth to be returned for the tree. By default the full tree will be returned.
- **filters** ()
  Optional filters that will reduce the product population and only provide nodes with at least one product in it (for advanced usages only)
  Filter example: `my-prop1~my-value`
        


## Responses
### 200
Successfully returned navigation tree content

#### Body: application/json (object)
- **status** (string)

- **result** (object)


### 404
Unknown navigation tree id

#### Body: application/json (object)
- **status** (string)

- **message** (string)



[Powered by Bump.sh](https://bump.sh)