---
title: "Search agents"
method: GET
path: "/well-known/agents"
tags: ["WellKnown"]
---

# Search agents

`GET /well-known/agents`

## Query parameters

- `offset` integer
- `limit` integer
- `name` string
- `skill` string[]
- `capability` string[]
- `inputMode` string[]
- `outputMode` string[]

## Response `200`

Agent search results.

- AgentSearchResults — Search results for agent cards.
  - `count` integer, required
  - `agents` AgentSearchResult[], required
    - `groupId` string
    - `artifactId` string
    - `name` string
    - `description` string
    - `version` string
    - `supportedInterfaces` AgentInterface[]
      - `url` string
      - `protocolBinding` string
      - `protocolVersion` string
      - `tenant` string
    - `skills` string[]
    - `capabilities` AgentCapabilities — Capabilities of an A2A agent.
      - `streaming` boolean
      - `pushNotifications` boolean
      - `extendedAgentCard` boolean
      - `extensions` AgentExtension[]
        - `uri` string
        - `description` string
        - `required` boolean
        - `params` object
    - `createdOn` integer
    - `owner` string

## Other responses

- `401` — Common response for all operations that can return a `401` error indicating authentication is required.
- `403` — Common response for all operations that can return a `403` error indicating the user is authenticated but not authorized.
- `500` — Common response for all operations that can fail with an unexpected server error.

---

[API](https://skmtc.net/apicurio/apis/apicurio-registry-api-v3.md) · [All operations](https://skmtc.net/apicurio/apis/apicurio-registry-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/apicurio/apicurio-registry-api-v3/revisions/c39cb56d7dbc/schema)