---
title: "Retrieve all the taxonomies and their children."
method: GET
path: "/authoring/v2/categories"
tags: ["Authoring categories"]
---

# Retrieve all the taxonomies and their children.

`GET /authoring/v2/categories`

Retrieve all the taxonomies and thier children.  Optional depth query string limits the depth of the categories returned.<br />User roles: admin, manager, editor, viewer

## Query parameters

- `offset` number
- `limit` number
- `depth` number

## Response `200`

The child categories were successfully retrieved.

- object
  - `limit` integer — The page size.
  - `offset` integer — The number of items to skip from the beginning of the list.
  - `href` string — A link to the current page.
  - `next` string — A link to the next page. Only shown if a next page exists.
  - `previous` string — A link to the previous page. Only shown if a previous page exists.
  - `items` object[]
    - `id` string, required — The ID of category.
    - `rev` string, required — The revision of category.
    - `name` string, required — The name of the category.
    - `classification` string, required — Either a Taxonomy or category.
    - `description` string — A written representation of the category.
    - `creatorId` string — The uuid of the user who created the category.
    - `permanent` boolean — Used to identify system categories, if true the category can not be deleted.
    - `hidden` boolean — If true the category is hidden in the Shell, value is not returned if false. Default is false.
    - `firstClassFor` string — Array of item classifications to which this taxonomy is enabled. Acceptable values "" and "imagesAndVideos", default "". By default the taxonomy is only shown where generic selection of any category in any taxonomy is allowed.
    - `parent` string — The ID of the parent category. This is only required if the classification is a CATEGORY.
    - `ancestorIds` string[] — An array of IDs for each of the category's ancestor categories. The ID of this category is not included.
    - `namePath` string[], required — An array of names for each of the category's ancestor categories, in addition to the name of this category.
    - `tags` string[] — Array of tags. This field is applicable only for taxonomy.
    - `links` object, required — A set of links to related documents.
      - `self` object
        - `href` string
      - `taxonomy` object — A link to this category's taxonomy. This will only be included if this category is not a taxonomy.
        - `href` string
      - `parent` object — A link to this category's parent. This will only be included if this category is not a taxonomy.
        - `href` string
    - `lastModified` string, date, required — When the category was last modified in ISO 8601 format.
    - `created` string, date, required — When the category was created in ISO 8601 format.

## Other responses

- `429` — Too Many Requests, the server has reached a limit, the request must be sent again at a later time.

---

[API](https://skmtc.dev/goacoustic/apis/acoustic-content-api.md) · [All operations](https://skmtc.dev/goacoustic/apis/acoustic-content-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/goacoustic/acoustic-content-api/revisions/677305266d89/schema)