---
title: "List all metadata templates for enterprise"
method: GET
path: "/metadata_templates/enterprise"
tags: ["Metadata templates"]
---

# List all metadata templates for enterprise

`GET /metadata_templates/enterprise`

Used to retrieve all metadata templates created to be used specifically within
the user's enterprise.

## Query parameters

- `marker` string
- `limit` integer

## Response `200`

Returns all of the metadata templates within an enterprise
and their corresponding schema.

- MetadataTemplates — 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` MetadataTemplate[] — A list of metadata templates.
    - `id` string, required — The ID of the metadata template.
    - `type` 'metadata_template', required — The value will always be `metadata_template`.
    - `scope` string — The scope of the metadata template can either be `global` or `enterprise_*`. The `global` scope is used for templates that are available to any Box enterprise. The `enterprise_*` scope represents templates that have been created within a specific enterprise, where `*` will be the ID of that enterprise.
    - `templateKey` string — A unique identifier for the template. This identifier is unique across the `scope` of the enterprise to which the metadata template is being applied, yet is not necessarily unique across different enterprises.
    - `displayName` string — The display name of the template. This can be seen in the Box web app and mobile apps.
    - `hidden` boolean — Defines if this template is visible in the Box web app UI, or if it is purely intended for usage through the API.
    - `fields` object[] — An ordered list of template fields which are part of the template. Each field can be a regular text field, date field, number field, as well as a single or multi-select list.
      - `type` 'string' | 'float' | 'date' | 'enum' | 'multiSelect' | 'taxonomy' | 'integer', required — The type of field. The basic fields are a `string` field for text, a `float` field for numbers, and a `date` fields to present the user with a date-time picker. Additionally, metadata templates support an `enum` field for a basic list of items, and `multiSelect` field for a similar list of items where the user can select more than one value. Metadata taxonomies are also supported as a `taxonomy` field type with a specific set of additional properties, which describe its structure. **Note**: The `integer` value is deprecated. It is still present in the response, but cannot be used in the POST request.
      - `key` string, required — A unique identifier for the field. The identifier must be unique within the template to which it belongs.
      - `displayName` string, required — The display name of the field as it is shown to the user in the web and mobile apps.
      - `description` string — A description of the field. This is not shown to the user.
      - `hidden` boolean — Whether this field is hidden in the UI for the user and can only be set through the API instead.
      - `options` object[] — A list of options for this field. This is used in combination with the `enum` and `multiSelect` field types.
        - `key` string, required — The text value of the option. This represents both the display name of the option and the internal key used when updating templates.
        - `id` string — The internal unique identifier of the option.
      - `taxonomyKey` string — The unique key of the metadata taxonomy to use for this taxonomy field. This property is required when the field `type` is set to `taxonomy`.
      - `taxonomyId` string — The unique ID of the metadata taxonomy to use for this taxonomy field. This property is required when the field `type` is set to `taxonomy`.
      - `namespace` string — The namespace of the metadata taxonomy to use for this taxonomy field. This property is required when the field `type` is set to `taxonomy`.
      - `optionsRules` object — An object defining additional rules for the options of the taxonomy field. This property is required when the field `type` is set to `taxonomy`.
        - `multiSelect` boolean — Whether to allow users to select multiple values.
        - `selectableLevels` integer[] — An array of integers defining which levels of the taxonomy are selectable by users.
      - `id` string — The unique ID of the metadata template field.
    - `copyInstanceOnItemCopy` boolean — Whether or not to include the metadata when a file or folder is copied.

## 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/revisions/ba8f087e1a4d/schema)