---
title: "Changes to Search for packages"
method: GET
path: "/api/v1/catalog/search"
---

# Changes to Search for packages

`GET /api/v1/catalog/search`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 14 of 53 revisions.

- **2026-08-27** `8ec561551880` — 2 breaking, 4 warning, 1 info
- **2026-07-23** `05d6283fc201` — 1 breaking, 1 warning, 1 info
- **2026-03-18** `b99206a49d27` — 1 info
- **2025-07-23** `29c059f1823a` — 1 info
- **2025-04-18** `03a19e372fd8` — 1 breaking, 1 info
- **2025-02-10** `b1a16c027df3` — 1 info
- **2024-11-20** `da0b62672ad1` — 3 info
- **2024-10-03** `00ece6bb6c91` — 1 warning, 1 info
- **2024-09-12** `49bbb9914d80` — 1 warning
- **2024-06-13** `201fc251983f` — 8 breaking
- **2024-05-02** `26f195045991` — 5 breaking, 5 info
- **2024-04-24** `0e6180566a8c` — 3 breaking
- **2024-04-17** `33d27da64c2d` — 7 breaking, 1 warning, 5 info
- **2024-04-11** `7ba31661b446` — 7 breaking, 2 warning, 11 info

## Changes

- **2026-08-27** `8ec561551880` — 2 breaking, 4 warning, 1 info
  - the `items/items/deprecation` response's property type changed from `object` to no type for status `200`
  - removed the required property `items/items/deprecation/kind` from the response with the `200` status
  - for the `query` request parameter `page`, the min was set to `0.00`
  - for the `query` request parameter `pageSize`, the min was set to `0.00`
  - removed the optional property `items/items/deprecation/message` from the response with the `200` status
  - removed the optional property `items/items/deprecation/replacement` from the response with the `200` status
  - added `#/components/schemas/DeprecationInfo` to the `items/items/deprecation` response property `allOf` list for the response status `200`
- **2026-07-23** `05d6283fc201` — 1 breaking, 1 warning, 1 info
  - for the `query` request parameter `search_term`, the minLength was increased from `0` to `2`
  - for the `query` request parameter `search_term`, the maxLength was set to `200`
  - removed the pattern `[a-zA-Z0-9\-\.\\@%_,]{2,200}` from the `query` request parameter `search_term`
- **2026-03-18** `b99206a49d27` — 1 info
  - added the optional property `items/items/deprecation` to the response with the `200` status
- **2025-07-23** `29c059f1823a` — 1 info
  - the endpoint scheme security `HTTPBasic` was added to the API
- **2025-04-18** `03a19e372fd8` — 1 breaking, 1 info
  - for the `query` request parameter `catalogs`, default value `nixpkgs` was removed
  - the `query` request parameter `search_term` became optional
- **2025-02-10** `b1a16c027df3` — 1 info
  - added the required property `items/items/version` to the response with the `200` status
- **2024-11-20** `da0b62672ad1` — 3 info
  - the endpoint scheme security `HTTPBearer` was added to the API
  - added the required property `items/items/catalog` to the response with the `200` status
  - added the required property `items/items/pkg_path` to the response with the `200` status
- **2024-10-03** `00ece6bb6c91` — 1 warning, 1 info
  - added the new `invalid` enum value to the `items/items/system` response property for the response status `200`
  - added the new enum value `invalid` to the `query` request parameter `system`
- **2024-09-12** `49bbb9914d80` — 1 warning
  - changed the pattern of the `query` request parameter `search_term` from `[a-zA-Z0-9\-\._,]{2,200}` to `[a-zA-Z0-9\-\.\\@%_,]{2,200}`
- **2024-06-13** `201fc251983f` — 8 breaking
  - removed the required property `items/items/license` from the response with the `200` status
  - removed the required property `items/items/locked_url` from the response with the `200` status
  - removed the required property `items/items/outputs` from the response with the `200` status
  - removed the required property `items/items/outputs_to_install` from the response with the `200` status
  - removed the required property `items/items/rev` from the response with the `200` status
  - removed the required property `items/items/rev_count` from the response with the `200` status
  - removed the required property `items/items/rev_date` from the response with the `200` status
  - removed the required property `items/items/version` from the response with the `200` status
- **2024-05-02** `26f195045991` — 5 breaking, 5 info
  - the `items/items/description` response's property type changed from no type to `string` for status `200`
  - the `items/items/license` response's property type changed from no type to `string` for status `200`
  - the `items/items/outputs` response's property type changed from no type to `array` for status `200`
  - the `items/items/outputs_to_install` response's property type changed from no type to `array` for status `200`
  - removed the required property `status_code` from the response with the `422` status
  - for the `query` request parameter `catalogs`, the type was generalized from no type to `string`
  - removed `subschema #1` from the `items/items/description` response property `anyOf` list for the response status `200`
  - removed `subschema #1` from the `items/items/license` response property `anyOf` list for the response status `200`
  - removed `subschema #1` from the `items/items/outputs` response property `anyOf` list for the response status `200`
  - removed `subschema #1` from the `items/items/outputs_to_install` response property `anyOf` list for the response status `200`
- **2024-04-24** `0e6180566a8c` — 3 breaking
  - response property `items/items/outputs` list-of-types was widened by adding types `array` to media type `application/json` of response `200`
  - the `items/items/outputs/anyOf[subschema #1]/` response's property type changed from `object` to `array` for status `200`
  - the `items/items/outputs_to_install/anyOf[subschema #1]/items/` response's property type changed from no type to `string` for status `200`
- **2024-04-17** `33d27da64c2d` — 7 breaking, 1 warning, 5 info
  - added the new required `query` request parameter `search_term`
  - the response property `items/items/description` became nullable for the status `200`
  - the response property `items/items/license` became nullable for the status `200`
  - the `detail` response's property type changed from `array` to `string` for status `422`
  - the `items/items/description` response's property type changed from `string` to no type for status `200`
  - the `items/items/license` response's property type changed from `string` to no type for status `200`
  - the `items/items/rev_date` response's property type changed from `integer` to `string`, and format from no format to `date-time` for status `200`
  - deleted the `query` request parameter `name`
  - the `query` request parameter `catalogs` became optional
  - added `subschema #1` to the `items/items/description` response property `anyOf` list for the response status `200`
  - added `subschema #1` to the `items/items/license` response property `anyOf` list for the response status `200`
  - the response property `detail` became required for the status `422`
  - added the required property `status_code` to the response with the `422` status
- **2024-04-11** `7ba31661b446` — 7 breaking, 2 warning, 11 info
  - added the new required `query` request parameter `name`
  - the `query` request parameter `catalogs` became required
  - removed the enum value `invalid` from the `query` request parameter `system`
  - the response property `detail` became optional for the status `422`
  - the `detail` response's property type changed from `string` to `array` for status `422`
  - removed the required property `items/items/catalog` from the response with the `200` status
  - removed the required property `items/items/pkg_path` from the response with the `200` status
  - deleted the `query` request parameter `search_term`
  - removed the optional property `items/items/deprecation` from the response with the `200` status
  - the endpoint scheme security `HTTPBasic` was removed from the API
  - the endpoint scheme security `HTTPBearer` was removed from the API
  - for the `query` request parameter `catalogs`, the type was generalized from `string` to no type
  - removed the `invalid` enum value from the `items/items/system` response property for the response status `200`
  - added the required property `items/items/license` to the response with the `200` status
  - added the required property `items/items/locked_url` to the response with the `200` status
  - added the required property `items/items/outputs` to the response with the `200` status
  - added the required property `items/items/outputs_to_install` to the response with the `200` status
  - added the required property `items/items/rev` to the response with the `200` status
  - added the required property `items/items/rev_count` to the response with the `200` status
  - added the required property `items/items/rev_date` to the response with the `200` status

---

[Operation](https://skmtc.dev/flox/apis/floxhub-catalog-server/docs/api/v1/catalog/search/get.md) · [API](https://skmtc.dev/flox/apis/floxhub-catalog-server.md) · [Page](https://skmtc.dev/flox/apis/floxhub-catalog-server/changes/api/v1/catalog/search/get)
