---
title: "List"
method: GET
path: "/api/v1/policies"
tags: ["Policy"]
---

# List

`GET /api/v1/policies`

List policies.

## Query parameters

- `page_size` integer — The pageSize field.
- `page_token` string — The pageToken field.

## Response `200`

Successful response

- C1ApiPolicyV1ListPolicyResponse — The ListPolicyResponse message.
  - `list` C1ApiPolicyV1Policy[], nullable — The list of results containing up to X results, where X is the page size defined in the request
    - `createdAt` string, date-time
    - `deletedAt` string, date-time
    - `description` string — The description of the Policy.
    - `displayName` string — The display name of the Policy.
    - `id` string — The ID of the Policy.
    - `policySteps` object — A map of string(policy type) to steps in a policy. This structure is leftover from a previous design, and should only ever have one key->value set.
    - `policyType` 'POLICY_TYPE_UNSPECIFIED' | 'POLICY_TYPE_GRANT' | 'POLICY_TYPE_REVOKE' | 'POLICY_TYPE_CERTIFY' | 'POLICY_TYPE_ACCESS_REQUEST' | 'POLICY_TYPE_PROVISION' — Indicates the type of this policy. Can also be used to get the value from policySteps.
    - `postActions` C1ApiPolicyV1PolicyPostActions[], nullable — An array of actions (ordered) to take place after a policy completes processing.
      - `certifyRemediateImmediately` boolean, nullable — ONLY valid when used in a CERTIFY Ticket Type: Causes any deprovision or change in a grant to be applied when Certify Ticket is closed. This field is part of the `action` oneof. See the documentation for `c1.api.policy.v1.PolicyPostActions` for more details.
    - `reassignTasksToDelegates` boolean — Deprecated. Use setting in policy step instead
    - `rules` C1ApiPolicyV1Rule[], nullable — The rules field.
      - `condition` string — The condition field.
      - `policyKey` string — This is a reference to a list of policy steps from `policy_steps`
    - `systemBuiltin` boolean — Whether this policy is a builtin system policy. Builtin system policies cannot be edited.
    - `updatedAt` string, date-time
  - `nextPageToken` string — The nextPageToken is shown for the next page if the number of results is larger than the max page size. The server returns one page of results and the nextPageToken until all results are retreived. To retrieve the next page, use the same request and append a pageToken field with the value of nextPageToken shown on the previous page.

## Changes

- **2025-08-06** `e09d811ca082` — 5 info
  - added the optional property `list/items/policySteps/additionalProperties/steps/items/approval/agent/agentFailureAction` to the response with the `200` status
  - added the optional property `list/items/policySteps/additionalProperties/steps/items/approval/agent/reassignToUserIds` to the response with the `200` status
  - added the optional property `list/items/policySteps/additionalProperties/steps/items/approval/allowDelegation` to the response with the `200` status
  - added the optional property `list/items/policySteps/additionalProperties/steps/items/form` to the response with the `200` status
  - …1 more
- **2025-06-24** `f5a989bebcdb` — 1 info
  - added the optional property `list/items/policySteps/additionalProperties/steps/items/provision/provisionPolicy/connector/deleteAccount` to the response with the `200` status
- **2025-05-30** `d5c56e8615fe` — 3 info
  - added the optional property `list/items/policySteps/additionalProperties/steps/items/approval/agent/agentMode` to the response with the `200` status
  - added the optional property `list/items/policySteps/additionalProperties/steps/items/approval/escalation` to the response with the `200` status
  - added the optional property `list/items/policySteps/additionalProperties/steps/items/approval/escalationEnabled` to the response with the `200` status
- …earlier changes not shown

[Full history](https://skmtc.dev/conductorone/apis/c1-api/changes/api/v1/policies/get.md)

---

[API](https://skmtc.dev/conductorone/apis/c1-api.md) · [All operations](https://skmtc.dev/conductorone/apis/c1-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/conductorone/c1-api/revisions/e09d811ca082/schema)