---
title: "Retrieves a built-in policy definition."
method: GET
path: "/providers/Microsoft.Authorization/policyDefinitions/{policyDefinitionName}"
tags: ["PolicyDefinitions"]
---

# Retrieves a built-in policy definition.

`GET /providers/Microsoft.Authorization/policyDefinitions/{policyDefinitionName}`

This operation retrieves the built-in policy definition with the given name.

## Path parameters

- `policyDefinitionName` string, required

## Query parameters

- `api-version` string, required

## Response `200`

OK - Returns information about the built-in policy definition.

- PolicyDefinition — The policy definition.
  - `properties` PolicyDefinitionProperties — The policy definition properties.
    - `policyType` 'NotSpecified' | 'BuiltIn' | 'Custom' — The type of policy definition. Possible values are NotSpecified, BuiltIn, and Custom.
    - `mode` string — The policy definition mode. Some examples are All, Indexed, Microsoft.KeyVault.Data.
    - `displayName` string — The display name of the policy definition.
    - `description` string — The policy definition description.
    - `policyRule` object — The policy rule.
    - `metadata` object — The policy definition metadata.
    - `parameters` object — Required if a parameter is used in policy rule.
  - `id` string — The ID of the policy definition.
  - `name` string — The name of the policy definition.
  - `type` string — The type of the resource (Microsoft.Authorization/policyDefinitions).

---

[API](https://skmtc.net/azure/apis/policyclient-3.md) · [All operations](https://skmtc.net/azure/apis/policyclient-3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/policyclient-3/revisions/c3ad0ac89443/schema)