---
title: "Search packages that meet the provided criteria"
method: GET
path: "/packages/search"
tags: ["Packages"]
---

# Search packages that meet the provided criteria

`GET /packages/search`

## Request

- Base URL: `https://artifacthub.io/api/v1`
- URL: `https://artifacthub.io/api/v1/packages/search`
- Auth: none declared
- TypeScript: <https://skmtc.dev/artifacthub/apis/artifact-hub/docs/packages/search/get.ts> (a function with typed inputs; its response is checked against the schema)

Search packages that meet the provided criteria

## Query parameters

- `offset` integer
- `limit` integer
- `facets` boolean, required
- `ts_query_web` string
- `kind` RepositoryKind[]
- `category` integer[]
- `user` string[]
- `org` string[]
- `repo` string[]
- `license` string[]
- `capabilities` string[]
- `deprecated` boolean
- `operators` boolean
- `verified_publisher` boolean
- `official` boolean
- `cncf` boolean
- `sort` 'relevance' | 'stars' | 'last_updated'

## Response `200`

- object
  - `packages` PackageSummary[]
    - `package_id` string, uuid, required
    - `name` string, required
    - `normalized_name` string, required
    - `logo_image_id` string
    - `display_name` string
    - `description` string
    - `version` string, required
    - `app_version` string
    - `license` string
    - `deprecated` boolean
    - `signed` boolean
    - `signatures` string[]
    - `official` boolean
    - `cncf` boolean, nullable
    - `ts` integer, required
    - `repository` RepositorySummary, required
      - `repository_id` string, uuid, required
      - `kind` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27, required: Repository kind: * `0` - Helm charts * `1` - Falco rules * `2` - OPA policies * `3` - OLM operators * `4` - Tinkerbell actions * `5` - Krew kubectl plugins * `6` - Helm plugins * `7` - Tekton tasks * `8` - KEDA scalers * `9` - Core DNS plugins * `10` - Keptn integrations * `11` - Tekton pipelines * `12` - Container images * `13` - Kubewarden policies * `14` - Gatekeeper policies * `15` - Kyverno policies * `16` - Knative client plugins * `17` - Backstage plugins * `18` - Argo templates * `19` - KubeArmor templates * `20` - KCL packages * `21` - Headlamp plugins * `22` - Inspektor gadgets * `23` - Tekton stepactions * `24` - Meshery designs * `25` - Opencost plugins * `26` - Radius recipes * `27` - Bootable containers * `28` - Kagent agents
      - `name` string, required
      - `display_name` string
      - `url` string, uri, required
      - `verified_publisher` boolean, required
      - `official` boolean, required
      - `cncf` boolean, nullable
      - `private` boolean
      - `scanner_disabled` boolean, required
      - `user_alias` string
      - `organization_name` string
      - `organization_display_name` string
    - `security_report_summary` object
      - `critical` number
      - `high` number
      - `medium` number
      - `low` number
      - `unknown` number
    - `all_containers_images_whitelisted` boolean
    - `production_organizations_count` number
    - `category` 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11: Package category: * `1` - AI / Machine learning * `2` - Database * `3` - Integration and delivery * `4` - Monitoring and logging * `5` - Networking * `6` - Security * `7` - Storage * `8` - Streaming and messaging * `9` - Analytics * `10` - Data processing * `11` - Web applications
    - `category_display_name` string
    - `stars` integer, required
  - `facets` Facets[]
    - `filter_key` string, required
    - `title` string, required
    - `options` object[], required
      - `id` string, required
      - `name` string, required
      - `total` integer, required
      - `filter_key` string

## Other responses

- `400`: The request sent was not valid
- `429`: The user has sent too many requests in a given amount of time
- `500`: The server encountered an unexpected condition that prevented it from fulfilling the request

## Changes

- **2026-11-06** `d2e9234264b1`: 3 warning, 4 info
  - added the new `10.00` enum value to the `packages/items/allOf[subschema #2]/category` response property for the response status `200`
  - added the new `11.00` enum value to the `packages/items/allOf[subschema #2]/category` response property for the response status `200`
  - added the new `9.00` enum value to the `packages/items/allOf[subschema #2]/category` response property for the response status `200`
  - added the enum value `10.00` to the property `items/` of the `query` request parameter `category`
  - …3 more
- **2025-02-01** `081ff21a6f42`: 6 warning, 6 info
  - added the new `22.00` enum value to the `packages/items/allOf[#/components/schemas/PackageBase]/repository/kind` response property for the response status `200`
  - added the new `23.00` enum value to the `packages/items/allOf[#/components/schemas/PackageBase]/repository/kind` response property for the response status `200`
  - added the new `24.00` enum value to the `packages/items/allOf[#/components/schemas/PackageBase]/repository/kind` response property for the response status `200`
  - added the new `25.00` enum value to the `packages/items/allOf[#/components/schemas/PackageBase]/repository/kind` response property for the response status `200`
  - …8 more

[Operation history](https://skmtc.dev/artifacthub/apis/artifact-hub/changes/packages/search/get.md)

---

[API](https://skmtc.dev/artifacthub/apis/artifact-hub.md) - [All operations](https://skmtc.dev/artifacthub/apis/artifact-hub/llms.txt) - [OpenAPI document](https://skmtc.dev/artifacthub/apis/artifact-hub/revisions/d2e9234264b1?raw)