---
title: "Gets a specific A2A agent by ID"
method: GET
path: "/a2a/agents/{id}"
tags: ["A2A"]
---

# Gets a specific A2A agent by ID

`GET /a2a/agents/{id}`

Gets a specific A2A agent by its unique identifier. Only accessible when EXPOSE_A2A is enabled.

## Path parameters

- `id` string, required

## Response `200`

Successful response

- A2AAgentCard — An AgentCard conveys key information: - Overall details (version, name, description, uses) - Skills: A set of capabilities the agent can perform - Default modalities/content types supported by the agent. - Authentication requirements
  - `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
- `404` — Agent not found
- `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/:id/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/70bffe5f3ff6/schema)