---
title: "Search Catalog"
method: GET
path: "/v1/registries/catalog/search"
tags: ["v1", "protected", "registries"]
---

# Search Catalog

`GET /v1/registries/catalog/search`

Search across all registry catalogs in the workspace.

## Query parameters

- `q` string, nullable — Search query
- `tag` string, nullable
- `update_available` boolean, nullable
- `limit` integer
- `offset` integer

## Response `200`

Successful Response

- RegistryItemResponse[]
  - `category` string, nullable
  - `created_at` string, required
  - `description` string, nullable, required
  - `external_id` string, required
  - `featured` boolean
  - `id` string, uuid, required
  - `installed_entity_id` string, uuid, nullable, required
  - `installed_version` string, nullable, required
  - `name` string, required
  - `registry_id` string, uuid, required
  - `spec` object, required
  - `tags` string[], required
  - `update_available` boolean, required
  - `updated_at` string, required
  - `version` string, nullable, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-08-30** `63db2f11302d` — 2 info
  - added the optional property `items/category` to the response with the `200` status
  - added the optional property `items/featured` to the response with the `200` status
- **2026-07-08** `8940d7f77282` — 2 breaking
  - the `items/created_at` response's property type/format changed from `string`/`date-time` to `string`/`` for status `200`
  - the `items/updated_at` response's property type/format changed from `string`/`date-time` to `string`/`` for status `200`

[Change history](https://skmtc.dev/agentarea/apis/agentarea-api/changes/v1/registries/catalog/search/get.md)

---

[API](https://skmtc.dev/agentarea/apis/agentarea-api.md) · [All operations](https://skmtc.dev/agentarea/apis/agentarea-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/agentarea/agentarea-api/revisions/99cf61829c55/schema)