---
title: "Get policy"
method: GET
path: "/v2/policies/{policy_id}"
tags: ["Policies"]
---

# Get policy

`GET /v2/policies/{policy_id}`

## Request

- Base URL: `https://my.orq.ai`
- URL: `https://my.orq.ai/v2/policies/{policy_id}`
- Auth: HTTP bearer

Retrieves the details of an existing policy by ID.

## Path parameters

- `policy_id` string, required: The ID of the policy

## Response `200`

Policy retrieved successfully

- object
  - `_id` string, required
  - `created_at` string, date-time, required
  - `created_by_id` string, required
  - `description` string
  - `display_name` string, required
  - `enabled` boolean, required
  - `evaluators` EvaluatorRef[], nullable
    - `execute_on` 'input' | 'output' | 'both', required
    - `id` string, required
    - `is_guardrail` boolean
    - `options` object
    - `sample_rate` number, double
    - `timeout` integer
  - `limits` Limits
    - `budget` BudgetLimit
      - `amount` number, double, required
      - `currency` 'usd', required
      - `period` 'hour' | 'day' | 'week' | 'month', required
    - `requests` RequestLimit
      - `amount` integer, required
      - `period` 'hour' | 'day' | 'week' | 'month', required
    - `tokens` TokenLimit
      - `amount` integer, required
      - `period` 'hour' | 'day' | 'week' | 'month', required
  - `models_config` ModelsConfig
    - `fallback_on_codes` integer[], nullable
    - `mode` 'fallback' | 'latency_based' | 'weighted' | 'round_robin', required
    - `models` ModelRef[], nullable, required
      - `display_name` string
      - `integration_id` string
      - `model` string, required
      - `weight` number, double
  - `project_id` string, required
  - `retry_config` PolicyRetryConfig
    - `count` integer, required
    - `on_codes` integer[], nullable
  - `slug` string, required
  - `timeout` integer, required
  - `updated_at` string, date-time, required
  - `updated_by_id` string, required

## Other responses

- `404`: Policy not found

## Changes

> 554 revisions in range; 71 not diffed.

- **2026-10-23** `0b4e519a544f`: 1 info
  - added the optional property `models_config/fallback_on_codes` to the response with the `200` status
- **2026-10-23** `732aed62833a`: 1 warning
  - removed the optional property `models_config/fallback_on_codes` from the response with the `200` status
- **2026-10-22** `4f826b2c3a0e`: 1 info
  - added the optional property `models_config/fallback_on_codes` to the response with the `200` status
- **2026-10-22** `8f0dc569f247`: 1 warning
  - removed the optional property `models_config/fallback_on_codes` from the response with the `200` status
- **2026-10-21** `08b800d640e6`: 1 info
  - added the optional property `models_config/fallback_on_codes` to the response with the `200` status

[Operation history](https://skmtc.dev/orq-ai/apis/orq-ai-api/changes/v2/policies/:policy_id/get.md)

---

[API](https://skmtc.dev/orq-ai/apis/orq-ai-api.md) - [All operations](https://skmtc.dev/orq-ai/apis/orq-ai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/orq-ai/apis/orq-ai-api/revisions/928a71e92252?raw)