---
title: "Get metadata taxonomies for namespace"
method: GET
path: "/metadata_taxonomies/{namespace}"
tags: ["Metadata taxonomies"]
---

# Get metadata taxonomies for namespace

`GET /metadata_taxonomies/{namespace}`

Used to retrieve all metadata taxonomies in a namespace.

## Path parameters

- `namespace` string, required

## Query parameters

- `marker` string
- `limit` integer

## Response `200`

Returns all of the metadata taxonomies within a namespace
and their corresponding schema.

- MetadataTaxonomies — The part of an API response that describes marker based pagination.
  - `limit` integer — The limit that was used for these entries. This will be the same as the `limit` query parameter unless that value exceeded the maximum value allowed. The maximum value varies by API.
  - `next_marker` string, nullable — The marker for the start of the next page of results.
  - `prev_marker` string, nullable — The marker for the start of the previous page of results.
  - `entries` MetadataTaxonomy[] — A list of metadata taxonomies.
    - `id` string, required — A unique identifier of the metadata taxonomy.
    - `key` string — A unique identifier of the metadata taxonomy. The identifier must be unique within the namespace to which it belongs.
    - `displayName` string, required — The display name of the metadata taxonomy. This can be seen in the Box web app.
    - `namespace` string, required — A namespace that the metadata taxonomy is associated with.
    - `levels` MetadataTaxonomyLevel[] — Levels of the metadata taxonomy.
      - `displayName` string — The display name of the level as it is shown to the user.
      - `description` string — A description of the level.
      - `level` integer — An index of the level within the taxonomy. Levels are indexed starting from 1.

## Other responses

- `400` — Returned when the request parameters are not valid.
- `default` — An unexpected client error.

---

[API](https://skmtc.net/box/apis/platform-api.md) · [All operations](https://skmtc.net/box/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/box/platform-api/versions/ba8f087e1a4d/schema)