---
title: "List policies"
method: POST
path: "/public/v1/query/list_policies"
tags: ["Policies"]
---

# List policies

`POST /public/v1/query/list_policies`

List all policies within an organization.

## Request body

- V1GetPoliciesRequest
  - `organizationId` string, required — Unique identifier for a given organization.

## Response `200`

A successful response.

- V1GetPoliciesResponse
  - `policies` V1Policy[], required — A list of policies.
    - `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)