---
title: "GET /subscriptions/{subscriptionId}/providers/Microsoft.Authorization/policydefinitions"
method: GET
path: "/subscriptions/{subscriptionId}/providers/Microsoft.Authorization/policydefinitions"
tags: ["PolicyDefinitions"]
---

# GET /subscriptions/{subscriptionId}/providers/Microsoft.Authorization/policydefinitions

`GET /subscriptions/{subscriptionId}/providers/Microsoft.Authorization/policydefinitions`

Gets all the policy definitions for a subscription.

## Path parameters

- `subscriptionId` string, required

## Query parameters

- `$filter` string
- `api-version` string, required

## Response `200`

OK - Returns ana array of policy definitions.

- PolicyDefinitionListResult — List of policy definitions.
  - `value` PolicyDefinition[] — An array of policy definitions.
    - `properties` PolicyDefinitionProperties — The policy 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 definition.
      - `description` string — The policy definition description.
      - `policyRule` object — The policy rule.
    - `id` string — The ID of the policy definition.
    - `name` string — The name of the policy definition. If you do not specify a value for name, the value is inferred from the name value in the request URI.
  - `nextLink` string — The URL to use for getting the next set of results.

---

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