# Get category tree

Get all categories in their hierarchical tree structure. The response itself is a "fake" category whose children property contains all the real categories.

Endpoint: GET /categories-tree
Version: 3.5.0

## Header parameters:

  - `X-Musement-Application` (string)
    A partner's application value, used for analyzing API usage and to identify areas of improvement.

  - `X-Musement-Version` (string)
    The API version to use for the request.

When absent, the latest version is used by default, however the latest version may not be stable. Partners are encouraged to use the latest stable version: 3.4.0.
    Example: "3.4.0"

## Response 200 fields (application/json):

  - `children` (array, required)
    Level-one categories, which can be considered sub-categories to the root level.
    Example: [{"children":[{"children":[{"children":[],"code":"new-helicopter-ride","id":188,"level":"3","name":"Helicopter rides"}],"code":"new-air-activities","id":186,"level":"2","name":"Air activities"}],"code":"new-activities","id":185,"level":"1","name":"Activities"}]

  - `children.children` (array, required)
    Sub-categories, if any, which belong to the category.

  - `children.children.id` (integer, required)
    The category's numerical ID.

  - `children.children.level` (string, required)
    The category's level in the category tree.

  - `children.children.name` (string, required)
    The category's name, translated based on the Accept-Language header value.

  - `id` (integer, required)
    The category's numerical ID. At the root level, this value is fake.

  - `level` (string, required)
    The category's level in the category tree. At the root level, this value is fake.
    Example: "0"

  - `name` (string, required)
    The category's name, translated based on the Accept-Language header value. At the root level, this value is fake.

## Response default fields (application/json):

  - `code` (string, required)
    The internal Musement code for the error.
    Example: "0"

  - `message` (string, required)
    A message with a brief explanation of the error.
    Example: "There was an error"