---
title: "Get policy"
method: POST
path: "/public/v1/query/get_policy"
tags: ["Policies"]
---

# Get policy

`POST /public/v1/query/get_policy`

Get details about a policy.

## Request body

- V1GetPolicyRequest
  - `organizationId` string, required — Unique identifier for a given organization.
  - `policyId` string, required — Unique identifier for a given policy.

## Response `200`

A successful response.

- V1GetPolicyResponse
  - `policy` V1Policy, required
    - `policyId` string, required — Unique identifier for a given Policy.
    - `policyName` string, required — Human-readable name for a Policy.
    - `effect` 'EFFECT_ALLOW' | 'EFFECT_DENY', required
    - `createdAt` Externaldatav1Timestamp, required
      - `seconds` string, required
      - `nanos` string, required
    - `updatedAt` Externaldatav1Timestamp, required
      - `seconds` string, required
      - `nanos` string, required
    - `notes` string, required — Human-readable notes added by a User to describe a particular policy.
    - `consensus` string, required — A consensus expression that evalutes to true or false.
    - `condition` string, required — A condition expression that evalutes to true or false.

## Other responses

- `default` — An unexpected error response.

---

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