---
title: "Retrieves built-in policy set definitions."
method: GET
path: "/providers/Microsoft.Authorization/policySetDefinitions"
tags: ["PolicySetDefinitions"]
---

# Retrieves built-in policy set definitions.

`GET /providers/Microsoft.Authorization/policySetDefinitions`

This operation retrieves a list of all the built-in policy set definitions.

## Query parameters

- `api-version` string, required

## Response `200`

OK - Returns an array of built in policy set definitions.

- PolicySetDefinitionListResult — List of policy set definitions.
  - `value` PolicySetDefinition[] — An array of policy set definitions.
    - `properties` PolicySetDefinitionProperties — The policy set definition properties.
      - `policyType` 'NotSpecified' | 'BuiltIn' | 'Custom' — The type of policy definition. Possible values are NotSpecified, BuiltIn, and Custom.
      - `displayName` string — The display name of the policy set definition.
      - `description` string — The policy set definition description.
      - `metadata` object — The policy set definition metadata.
      - `parameters` object — The policy set definition parameters that can be used in policy definition references.
      - `policyDefinitions` PolicyDefinitionReference[], required — An array of policy definition references.
        - `policyDefinitionId` string — The ID of the policy definition or policy set definition.
        - `parameters` object — Required if a parameter is used in policy rule.
    - `id` string — The ID of the policy set definition.
    - `name` string — The name of the policy set definition.
    - `type` string — The type of the resource (Microsoft.Authorization/policySetDefinitions).
  - `nextLink` string — The URL to use for getting the next set of results.

## Other responses

- `default` — Error response describing why the operation failed.

---

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