---
title: "Get"
method: GET
path: "/api/v1/policies/{id}"
tags: ["Policy"]
---

# Get

`GET /api/v1/policies/{id}`

Get a policy by ID.

## Path parameters

- `id` string, required — The id field.

## Response `200`

The GetPolicyResponse message contains the policy object.

- C1ApiPolicyV1GetPolicyResponse — The GetPolicyResponse message contains the policy object.
  - `policy` C1ApiPolicyV1Policy — A policy describes the behavior of the ConductorOne system when processing a task. You can describe the type, approvers, fallback behavior, and escalation processes.
    - `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

## Changes

- **2025-09-08** `d8ad3d78289e` — 2 info
  - added the optional property `policy/policySteps/additionalProperties/steps/items/wait/duration` to the response with the `200` status
  - added the optional property `policy/policySteps/additionalProperties/steps/items/wait/untilTime` to the response with the `200` status
- **2025-08-20** `182cb087dfa4` — 1 warning, 1 info
  - removed the optional property `policy/policySteps/additionalProperties/steps/items/form/form/tenantId` from the response with the `200` status
  - added the optional property `policy/policySteps/additionalProperties/steps/items/form/form/fields/items/int64Field` to the response with the `200` status
- **2025-08-06** `e09d811ca082` — 5 info
  - added the optional property `policy/policySteps/additionalProperties/steps/items/approval/agent/agentFailureAction` to the response with the `200` status
  - added the optional property `policy/policySteps/additionalProperties/steps/items/approval/agent/reassignToUserIds` to the response with the `200` status
  - added the optional property `policy/policySteps/additionalProperties/steps/items/approval/allowDelegation` to the response with the `200` status
  - added the optional property `policy/policySteps/additionalProperties/steps/items/form` to the response with the `200` status
  - …1 more
- …earlier changes not shown

[Full history](https://skmtc.dev/conductorone/apis/c1-api/changes/api/v1/policies/:id/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.dev/conductorone/apis/c1-api/revisions/d8ad3d78289e?raw)