---
title: "Get metadata cascade policy"
method: GET
path: "/metadata_cascade_policies/{metadata_cascade_policy_id}"
tags: ["Metadata cascade policies"]
---

# Get metadata cascade policy

`GET /metadata_cascade_policies/{metadata_cascade_policy_id}`

Retrieve a specific metadata cascade policy assigned to a folder.

## Path parameters

- `metadata_cascade_policy_id` string, required

## Response `200`

Returns a metadata cascade policy.

- MetadataCascadePolicy — A metadata cascade policy automatically applies a metadata template instance to all the files and folders within the targeted folder.
  - `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

- `404` — Returns an error when the policy can not be found or the user does not have access to the folder. * `instance_not_found` - The policy could not be found * `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.dev/box/apis/platform-api.md) · [All operations](https://skmtc.dev/box/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/box/platform-api/revisions/ba8f087e1a4d/schema)