---
title: "Lists all the Policies"
method: GET
path: "/api/v2/policies"
tags: ["Policies"]
---

# Lists all the Policies

`GET /api/v2/policies`

## Request

- Base URL: `https://console.jumpcloud.com`
- URL: `https://console.jumpcloud.com/api/v2/policies`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/jumpcloud/apis/jumpcloud-console-api/docs/api/v2/policies/get.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint returns all policies.

##### Sample Request

```
 curl -X GET  https://console.jumpcloud.com/api/v2/policies \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
  ```

## Query parameters

- `fields` string[]
- `filter` string[]
- `limit` integer
- `skip` integer
- `sort` string[]

## Headers

- `x-org-id` string

## Response `200`

OK

- Policy[]
  - `id` string: ObjectId uniquely identifying a Policy.
  - `name` string: The description for this specific Policy.
  - `template` PolicyTemplate: The shallow information about a Policy Template.
    - `activation` string: Requirements before the policy can be activated.
    - `behavior` string: Specifics about the behavior of the policy.
    - `deliveryTypes` string[]: The supported delivery mechanisms for this policy template.
    - `description` string: The default description for the Policy.
    - `displayName` string: The default display name for the Policy.
    - `id` string: ObjectId uniquely identifying a Policy Template.
    - `name` string: The unique name for the Policy Template.
    - `osMetaFamily` 'linux' | 'darwin' | 'windows' | 'ios' | 'universal' | 'android'
    - `state` string: String describing the release status of the policy template.
    - `alert` string, nullable: Text to describe any risk associated with this policy.
    - `reference` string, nullable: URL to visit for further information.
    - `osRestrictions` OSRestriction[]
      - `osName` string: The name of the OS in which this restriction applies
      - `earliestVersion` string: The earliest version of the OS in which the policy can be applied
      - `isMdmRequired` boolean: Boolean representing if the policy requires the device to be MDM enrolled
      - `deprecatedVersion` string: The version of the OS in which the policy was deprecated
      - `supportedEnrollmentTypes` string[]: This field is deprecated and will be ignored. Use appleRestrictions.supportedEnrollmentTypes instead
      - `appleRestrictions` object: The Apple specific restricitons for this policy, if there are any
        - `requiresSupervision` boolean: Boolean representing if the policy requires the Apple devices to be MDM supervised
        - `supportedEnrollmentTypes` string[]: The supported Apple enrollment types for this policy

## Other responses

- `500`: Unexpected error.

---

[API](https://skmtc.dev/jumpcloud/apis/jumpcloud-console-api.md) - [All operations](https://skmtc.dev/jumpcloud/apis/jumpcloud-console-api/llms.txt) - [OpenAPI document](https://skmtc.dev/jumpcloud/apis/jumpcloud-console-api/revisions/f396d9271b46?raw)