---
title: "Lists the currently available A2A agents"
method: GET
path: "/a2a/agents"
tags: ["A2A"]
---

# Lists the currently available A2A agents

`GET /a2a/agents`

Lists the currently available A2A agents. Only accessible when EXPOSE_A2A is enabled.

## Response `200`

Successful response

- ListAgentsResponse — Response structure for listing A2A agents
  - `object` string, required — Always "list"
  - `data` A2AAgentCard[], required — Array of available A2A agents
    - `capabilities` unknown, required
    - `defaultInputModes` string[], required — The set of interaction modes that the agent supports across all skills. This can be overridden per-skill. Supported media types for input.
    - `defaultOutputModes` string[], required — Supported media types for output.
    - `description` string, required — A human-readable description of the agent. Used to assist users and other agents in understanding what the agent can do.
    - `documentationUrl` string — A URL to documentation for the agent.
    - `iconUrl` string — A URL to an icon for the agent.
    - `id` string, required — Unique identifier for the agent (base64-encoded SHA256 hash of the agent URL).
    - `name` string, required — Human readable name of the agent.
    - `provider` unknown
    - `security` object[] — Security requirements for contacting the agent.
    - `securitySchemes` object — Security scheme details used for authenticating with this agent.
    - `skills` unknown[], required — Skills are a unit of capability that an agent can perform.
      - unknown
    - `supportsAuthenticatedExtendedCard` boolean — true if the agent supports providing an extended agent card when the user is authenticated. Defaults to false if not specified.
    - `url` string, required — A URL to the address the agent is hosted at.
    - `version` string, required — The version of the agent - format is up to the provider.

## Other responses

- `401` — Unauthorized
- `403` — A2A agents endpoint is not exposed
- `500` — Internal server error

## Changes

- **2025-07-25** `70bffe5f3ff6` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/inference-gateway/apis/inference-gateway-api/changes/a2a/agents/get.md)

---

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