---
title: "Changes to Search for versions by content"
method: POST
path: "/search/versions"
---

# Changes to Search for versions by content

`POST /search/versions`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 11 of 126 revisions.

- **2026-10-31** `ff9684af2aad`: 20 info
- **2026-10-29** `f17f5df4e79c`: 4 info
- **2026-08-10** `b41a13d5e5e2`: 1 info
- **2026-06-23** `649594fdc80a`: 1 info
- **2026-05-18** `561c6d6c6989`: 1 warning
- **2025-12-16** `440db8997574`: 2 info
- **2024-10-23** `66022b1b6c9a`: 2 info
- **2024-10-23** `296c773f43a9`: 1 info
- **2024-10-15** `95e926f2874a`: 1 warning, 2 info
- **2024-09-06** `948bffd5d083`: 4 warning, 8 info
- **2024-06-03** `b4f9a63429d9`: 1 info

## Changes

- **2026-10-31** `ff9684af2aad`: 20 info
  - added the optional property `ruleViolation/causes/items/code` to the response with the `400` status
  - added the optional property `ruleViolation/causes/items/code` to the response with the `401` status
  - added the optional property `ruleViolation/causes/items/code` to the response with the `403` status
  - added the optional property `ruleViolation/causes/items/code` to the response with the `500` status
  - added the optional property `ruleViolation/causes/items/direction` to the response with the `400` status
  - added the optional property `ruleViolation/causes/items/direction` to the response with the `401` status
  - added the optional property `ruleViolation/causes/items/direction` to the response with the `403` status
  - added the optional property `ruleViolation/causes/items/direction` to the response with the `500` status
  - added the optional property `ruleViolation/causes/items/existing` to the response with the `400` status
  - added the optional property `ruleViolation/causes/items/existing` to the response with the `401` status
  - added the optional property `ruleViolation/causes/items/existing` to the response with the `403` status
  - added the optional property `ruleViolation/causes/items/existing` to the response with the `500` status
  - added the optional property `ruleViolation/causes/items/proposed` to the response with the `400` status
  - added the optional property `ruleViolation/causes/items/proposed` to the response with the `401` status
  - added the optional property `ruleViolation/causes/items/proposed` to the response with the `403` status
  - added the optional property `ruleViolation/causes/items/proposed` to the response with the `500` status
  - added the optional property `ruleViolation/ruleType` to the response with the `400` status
  - added the optional property `ruleViolation/ruleType` to the response with the `401` status
  - added the optional property `ruleViolation/ruleType` to the response with the `403` status
  - added the optional property `ruleViolation/ruleType` to the response with the `500` status
- **2026-10-29** `f17f5df4e79c`: 4 info
  - added the optional property `ruleViolation` to the response with the `400` status
  - added the optional property `ruleViolation` to the response with the `401` status
  - added the optional property `ruleViolation` to the response with the `403` status
  - added the optional property `ruleViolation` to the response with the `500` status
- **2026-08-10** `b41a13d5e5e2`: 1 info
  - added the new optional `query` request parameter `state`
- **2026-06-23** `649594fdc80a`: 1 info
  - added the new optional `query` request parameter `skipCount`
- **2026-05-18** `561c6d6c6989`: 1 warning
  - added the new `SUNSET` enum value to the `versions/items/state` response property for the response status `200`
- **2025-12-16** `440db8997574`: 2 info
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`
- **2024-10-23** `66022b1b6c9a`: 2 info
  - added the new enum value `artifactId` to the `query` request parameter `orderby`
  - added the new enum value `groupId` to the `query` request parameter `orderby`
- **2024-10-23** `296c773f43a9`: 1 info
  - added the optional property `versions/items/labels` to the response with the `200` status
- **2024-10-15** `95e926f2874a`: 1 warning, 2 info
  - added the new `DRAFT` enum value to the `versions/items/state` response property for the response status `200`
  - added the optional property `versions/items/modifiedBy` to the response with the `200` status
  - added the optional property `versions/items/modifiedOn` to the response with the `200` status
- **2024-09-06** `948bffd5d083`: 4 warning, 8 info
  - removed the optional property `error_code` from the response with the `400` status
  - removed the optional property `error_code` from the response with the `500` status
  - removed the optional property `message` from the response with the `400` status
  - removed the optional property `message` from the response with the `500` status
  - added the optional property `instance` to the response with the `400` status
  - added the optional property `instance` to the response with the `500` status
  - added the optional property `type` to the response with the `400` status
  - added the optional property `type` to the response with the `500` status
  - added the required property `status` to the response with the `400` status
  - added the required property `status` to the response with the `500` status
  - added the required property `title` to the response with the `400` status
  - added the required property `title` to the response with the `500` status
- **2024-06-03** `b4f9a63429d9`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/apicurio/apis/apicurio-registry-api-v3/docs/search/versions/post.md) - [API](https://skmtc.dev/apicurio/apis/apicurio-registry-api-v3.md) - [Page](https://skmtc.dev/apicurio/apis/apicurio-registry-api-v3/changes/search/versions/post)