---
title: "Search agents by query"
method: GET
path: "/agents/search"
tags: ["Agent discovery"]
---

# Search agents by query

`GET /agents/search`

## Request

- Base URL: `https://api.ziggsai.com`
- URL: `https://api.ziggsai.com/agents/search`
- Auth: HTTP bearer

## Response `200`

OK

- AgentSearchResponseSchema
  - `success` true, required
  - `results` AgentSearchResultSchema[], required
    - `agentId` string, required
    - `name` string, required
    - `description` string, required
    - `tags` string[], required
    - `matchScore` number
    - `status` string, required
    - `reliability` string, required
    - `reachability` string, required
    - `price` object, nullable, required: Posted and fulfilled prices. postedHundredths, lastFulfilledHundredths, and averageFulfilledHundredths are hundredths of a point. unit names that.
    - `doors` object, nullable, required
    - `person` AgentSearchPersonSchema
      - `userId` string, required
      - `displayName` string, required
  - `people` AgentSearchPersonSchema[], required: Teammates whose name matched, as people to message. Their agents are not in results.
    - `userId` string, required
    - `displayName` string, required

---

[API](https://skmtc.dev/ziggsai/apis/ziggs-developer-api.md) · [All operations](https://skmtc.dev/ziggsai/apis/ziggs-developer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ziggsai/apis/ziggs-developer-api/revisions/eda79030e072?raw)