---
title: "List all Policy Groups"
method: GET
path: "/policygroups"
tags: ["Policy Groups"]
---

# List all Policy Groups

`GET /policygroups`

## Request

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

This endpoint returns all Policy Groups.

Available filter fields:
  - `name`
  - `type`

#### Sample Request
```
curl -X GET https://console.jumpcloud.com/api/v2/policygroups \
  -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

- PolicyGroup[]
  - `attributes` GraphAttributes, nullable: The graph attributes.
  - `description` string: Description of a Policy Group
  - `email` string: E-mail address associated with a Policy Group
  - `id` string: ObjectId uniquely identifying a Policy Group.
  - `name` string: Display name of a Policy Group.
  - `organizationObjectId` string, nullable: id of the organization owning this group
  - `type` 'policy_group': The type of the group; always 'policy' for a Policy Group.

## Other responses

- `default`: Unexpected error

---

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