---
title: "Search Directory"
method: GET
path: "/api/kypa/search"
tags: ["kypa-directory"]
---

# Search Directory

`GET /api/kypa/search`

## Request

- Base URL: `https://api.kojiru.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.kojiru.com/api/kypa/search`
- Auth: none declared

Filter, sort and paginate the public directory.

## Query parameters

- `q` string, nullable: Free-text on agent_name / description / categories.
- `tier` string, nullable: Bronze | Silver | Gold | Platinum
- `framework` string, nullable: Framework filter.
- `min_acs` integer, nullable
- `max_slashes` integer, nullable
- `warning_flag` string, nullable: None | Yellow | Orange | Red
- `active_only` boolean
- `sort` string: Sort field.
- `order` string: asc | desc
- `limit` integer
- `offset` integer

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/kojiru/apis/kojiru-api.md) · [All operations](https://skmtc.dev/kojiru/apis/kojiru-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kojiru/apis/kojiru-api/revisions/7974409f57cd?raw)