---
title: "Discover Agents"
method: GET
path: "/api/v1/agents/discover"
tags: ["agents"]
---

# Discover Agents

`GET /api/v1/agents/discover`

## Request

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

Public agent discovery endpoint. No authentication required.

Returns agents with their trust scores, supporting filtering by
framework, capability, and active status, with cursor-based pagination.

## Query parameters

- `framework` string, nullable: Filter by framework_source (e.g. 'openclaw', 'crewai', 'langchain')
- `capability` string, nullable: Filter agents whose capabilities JSONB array contains this string
- `is_active` boolean: Filter by active status
- `sort` string: Sort field: trust_score (default), created_at, display_name
- `cursor` string, nullable: UUID cursor for pagination
- `limit` integer: Page size (max 100)

## Response `200`

Successful Response

- AgentDiscoveryResponse
  - `agents` AgentDiscoveryItem[], required
    - `id` string, uuid, required
    - `display_name` string, required
    - `type` string, required
    - `framework_source` string, nullable
    - `capabilities` string[], required
    - `autonomy_level` integer, nullable
    - `trust_score` number, nullable
    - `is_active` boolean, required
    - `is_provisional` boolean
    - `created_at` string, date-time, required
    - `last_seen_at` string, date-time, nullable
    - `bio_markdown` string, required
  - `next_cursor` string, nullable

## Other responses

- `422`: Validation Error

---

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