---
title: "Get Policy Versions"
method: GET
path: "/policies/{policy_id}/versions"
---

# Get Policy Versions

`GET /policies/{policy_id}/versions`

Get version history for a policy.

Returns a list of all versions (metadata only) ordered by timestamp descending.

Docs: [Guide](https://docs.grayswan.ai/policy-management/policies) |
[API Reference](https://docs.grayswan.ai/api-reference/policies/get-policy-versions)

Raises:
    ResourceNotFoundError: If the policy does not exist.

## Path parameters

- `policy_id` string, required

## Response `200`

Successful Response

- PolicyVersionListResponse — Response for version list endpoint.
  - `policy_id` string, required
  - `versions` PolicyVersionSummary[], required
    - `id` string, required
    - `operation` string, required
    - `timestamp` string, date-time, nullable
    - `user_id` string, nullable
    - `diff` object[], nullable
  - `total` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/grayswan/apis/gray-swan-ai-api.md) · [All operations](https://skmtc.net/grayswan/apis/gray-swan-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/grayswan/gray-swan-ai-api/revisions/6ef1ea32ff13/schema)