---
title: "List metadata cascade policies"
method: GET
path: "/metadata_cascade_policies"
tags: ["Metadata cascade policies"]
---

# List metadata cascade policies

`GET /metadata_cascade_policies`

Retrieves a list of all the metadata cascade policies
that are applied to a given folder. This can not be used on the root
folder with ID `0`.

## Query parameters

- `folder_id` string, required
- `owner_enterprise_id` string
- `marker` string
- `offset` integer

## Response `200`

Returns a list of metadata cascade policies.

- MetadataCascadePolicies — 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` MetadataCascadePolicy[] — A list of metadata cascade policies.
    - `id` string, required — The ID of the metadata cascade policy object.
    - `type` 'metadata_cascade_policy', required — The value will always be `metadata_cascade_policy`.
    - `owner_enterprise` object — The enterprise that owns this policy.
      - `type` 'enterprise' — The value will always be `enterprise`.
      - `id` string — The ID of the enterprise that owns the policy.
    - `parent` object — Represent the folder the policy is applied to.
      - `type` 'folder' — The value will always be `folder`.
      - `id` string — The ID of the folder the policy is applied to.
    - `scope` string — The scope of the metadata cascade policy can either be `global` or `enterprise_*`. The `global` scope is used for policies that are available to any Box enterprise. The `enterprise_*` scope represents policies that have been created within a specific enterprise, where `*` will be the ID of that enterprise.
    - `templateKey` string — The key of the template that is cascaded down to the folder's children. In many cases the template key is automatically derived of its display name, for example `Contract Template` would become `contractTemplate`. In some cases the creator of the template will have provided its own template key. Please [list the templates for an enterprise][list], or get all instances on a [file][file] or [folder][folder] to inspect a template's key. [list]: https://developer.box.com/reference/get-metadata-templates-enterprise [file]: https://developer.box.com/reference/get-files-id-metadata [folder]: https://developer.box.com/reference/get-folders-id-metadata

## Other responses

- `400` — Returns an error when any of the parameters are not in a valid format.
- `403` — Returns an error when the folder can not be accessed. This error often happens when accessing the root folder with ID `0`.
- `404` — Returns an error when the folder can not be found or the user does not have access to the folder. * `not_found` - The folder could not be found or the user does not have access to the folder.
- `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)