---
title: "Changes to List policy sets in a zone"
method: GET
path: "/zones/{zone_id}/policy-sets"
---

# Changes to List policy sets in a zone

`GET /zones/{zone_id}/policy-sets`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 8 of 25 revisions.

- **2026-10-29** `0dee67e0a73a`: 1 info
- **2026-10-16** `0cfaff865771`: 16 breaking, 8 warning, 88 info
- **2026-06-17** `1a0dd4d857ee`: 6 info
- **2026-05-07** `2abdf2efe2e6`: 1 info
- **2026-04-24** `fcab5a5e6cd0`: 2 breaking, 2 warning, 10 info
- **2026-04-20** `932699a5ea16`: 2 info
- **2026-04-02** `aee6e66de0d3`: 1 info
- **2026-03-16** `d3d69f45bfed`: 1 info

## Changes

- **2026-10-29** `0dee67e0a73a`: 1 info
  - added the new optional `query` request parameter `query`
- **2026-10-16** `0cfaff865771`: 16 breaking, 8 warning, 88 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/allOf[#/components/schemas/pdp_PolicySet]/created_by_user` to the response with the `200` status
  - added the optional property `items/items/allOf[#/components/schemas/pdp_PolicySet]/updated_by_user` to the response with the `200` status
  - added the optional property `items/items/allOf[subschema #2]/binding` to the response with the `200` status
  - added the optional property `items/items/allOf[subschema #2]/changes` to the response with the `200` status
  - added the optional property `items/items/allOf[subschema #2]/policy_set_version` to the response with the `200` status
  - added the optional property `items/items/allOf[subschema #2]/warnings` 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`
  - …72 more
- **2026-06-17** `1a0dd4d857ee`: 6 info
  - added the new optional `query` request parameter `filter[target_type]`
  - `query` request parameter `filter[scope_type]` was deprecated
  - added the optional property `items/items/allOf[subschema #2]/target_id` to the response with the `200` status
  - response property `items/items/allOf[#/components/schemas/pdp_PolicySet]/scope_type` deprecated
  - response property `items/items/allOf[subschema #2]/scope_target_id` deprecated
  - added the required property `items/items/allOf[#/components/schemas/pdp_PolicySet]/target_type` to the response with the `200` status
- **2026-05-07** `2abdf2efe2e6`: 1 info
  - added the new enum value `status` to the `query` request parameter `sort`
- **2026-04-24** `fcab5a5e6cd0`: 2 breaking, 2 warning, 10 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 `active`
  - added the new optional `query` request parameter `expand[]`
  - added the new optional `query` request parameter `filter[active]`
  - added the new optional `query` request parameter `filter[owner_type]`
  - added the new optional `query` request parameter `filter[scope_type]`
  - added the new optional `query` request parameter `query[]`
  - added the new optional `query` request parameter `query[name]`
  - `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-20** `932699a5ea16`: 2 info
  - added the optional property `items/items/allOf[subschema #2]/shadow_version` to the response with the `200` status
  - added the optional property `items/items/allOf[subschema #2]/shadow_version_id` to the response with the `200` status
- **2026-04-02** `aee6e66de0d3`: 1 info
  - the endpoint scheme security `OAuth2` was added to the API
- **2026-03-16** `d3d69f45bfed`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/keycardai/apis/keycard-ai-keycard-api/docs/zones/:zone_id/policy-sets/get.md) - [API](https://skmtc.dev/keycardai/apis/keycard-ai-keycard-api.md) - [Page](https://skmtc.dev/keycardai/apis/keycard-ai-keycard-api/changes/zones/:zone_id/policy-sets/get)
