---
title: "Changes to List versions of a policy"
method: GET
path: "/zones/{zone_id}/policies/{policy_id}/versions"
---

# Changes to List versions of a policy

`GET /zones/{zone_id}/policies/{policy_id}/versions`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 5 of 25 revisions.

- **2026-10-16** `0cfaff865771`: 16 breaking, 8 warning, 84 info
- **2026-05-06** `82ca6e382f13`: 1 breaking
- **2026-04-24** `fcab5a5e6cd0`: 2 breaking, 2 warning, 4 info
- **2026-04-02** `aee6e66de0d3`: 2 info
- **2026-03-16** `d3d69f45bfed`: 1 info

## Changes

- **2026-10-16** `0cfaff865771`: 16 breaking, 8 warning, 84 info
  - the response property `details/items/field` became optional for the status `400`
  - the response property `details/items/field` became optional for the status `401`
  - the response property `details/items/field` became optional for the status `403`
  - the response property `details/items/field` became optional for the status `404`
  - the response property `details/items/field` became optional for the status `429`
  - the response property `details/items/field` became optional for the status `500`
  - the response property `details/items/field` became optional for the status `503`
  - the response property `details/items/field` became optional for the status `default`
  - the `details/items/code` response's property type changed from `string` to no type for status `400`
  - the `details/items/code` response's property type changed from `string` to no type for status `401`
  - the `details/items/code` response's property type changed from `string` to no type for status `403`
  - the `details/items/code` response's property type changed from `string` to no type for status `404`
  - the `details/items/code` response's property type changed from `string` to no type for status `429`
  - the `details/items/code` response's property type changed from `string` to no type for status `500`
  - the `details/items/code` response's property type changed from `string` to no type for status `503`
  - the `details/items/code` response's property type changed from `string` to no type for status `default`
  - added the new `not_implemented` enum value to the `code` response property for the response status `400`
  - added the new `not_implemented` enum value to the `code` response property for the response status `401`
  - added the new `not_implemented` enum value to the `code` response property for the response status `403`
  - added the new `not_implemented` enum value to the `code` response property for the response status `404`
  - added the new `not_implemented` enum value to the `code` response property for the response status `429`
  - added the new `not_implemented` enum value to the `code` response property for the response status `500`
  - added the new `not_implemented` enum value to the `code` response property for the response status `503`
  - added the new `not_implemented` enum value to the `code` response property for the response status `default`
  - added the enum value `user` to the property `items/` of the `query` request parameter `expand`
  - added the enum value `user` to the property `items/` of the `query` request parameter `expand[]`
  - added the optional property `items/items/archived_by_user` to the response with the `200` status
  - added the optional property `items/items/created_by_user` to the response with the `200` status
  - added `#/components/schemas/pdp_ErrorCode, subschema #2` to the `details/items/code` response property `anyOf` list for the response status `400`
  - added `#/components/schemas/pdp_ErrorCode, subschema #2` to the `details/items/code` response property `anyOf` list for the response status `401`
  - added `#/components/schemas/pdp_ErrorCode, subschema #2` to the `details/items/code` response property `anyOf` list for the response status `403`
  - added `#/components/schemas/pdp_ErrorCode, subschema #2` to the `details/items/code` response property `anyOf` list for the response status `404`
  - added `#/components/schemas/pdp_ErrorCode, subschema #2` to the `details/items/code` response property `anyOf` list for the response status `429`
  - added `#/components/schemas/pdp_ErrorCode, subschema #2` to the `details/items/code` response property `anyOf` list for the response status `500`
  - added `#/components/schemas/pdp_ErrorCode, subschema #2` to the `details/items/code` response property `anyOf` list for the response status `503`
  - added `#/components/schemas/pdp_ErrorCode, subschema #2` to the `details/items/code` response property `anyOf` list for the response status `default`
  - removed the `bad_request` enum value from the `details/items/code` response property for the response status `400`
  - removed the `bad_request` enum value from the `details/items/code` response property for the response status `401`
  - removed the `bad_request` enum value from the `details/items/code` response property for the response status `403`
  - removed the `bad_request` enum value from the `details/items/code` response property for the response status `404`
  - …68 more
- **2026-05-06** `82ca6e382f13`: 1 breaking
  - for the `query` request parameter `format`, default value `json` was removed
- **2026-04-24** `fcab5a5e6cd0`: 2 breaking, 2 warning, 4 info
  - for the `query` request parameter `after`, the minLength was increased from `0` to `1`
  - for the `query` request parameter `before`, the minLength was increased from `0` to `1`
  - for the `query` request parameter `after`, the maxLength was set to `255`
  - for the `query` request parameter `before`, the maxLength was set to `255`
  - added the new optional `query` request parameter `expand[]`
  - `query` request parameter `expand` was deprecated
  - added `#/components/schemas/pdp_PaginationCursor` to the `pagination/after_cursor` response property `allOf` list for the response status `200`
  - added `#/components/schemas/pdp_PaginationCursor` to the `pagination/before_cursor` response property `allOf` list for the response status `200`
- **2026-04-02** `aee6e66de0d3`: 2 info
  - the endpoint scheme security `OAuth2` was added to the API
  - added the required property `items/items/owner_type` to the response with the `200` status
- **2026-03-16** `d3d69f45bfed`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/keycardai/apis/untitled-api/docs/zones/:zone_id/policies/:policy_id/versions/get.md) - [API](https://skmtc.dev/keycardai/apis/untitled-api.md) - [Page](https://skmtc.dev/keycardai/apis/untitled-api/changes/zones/:zone_id/policies/:policy_id/versions/get)
