---
title: "Get A2A agent card (v0.3 RPC)"
method: GET
path: "/v2/agents/{agent_key}/v1/card"
tags: ["A2A Protocol"]
---

# Get A2A agent card (v0.3 RPC)

`GET /v2/agents/{agent_key}/v1/card`

Returns the same v0.3 Agent Card as `.well-known/agent-card.json`, served at the v0.3 RPC URL `GET /v1/card`.

## Path parameters

- `agent_key` string, required — A unique key that identifies an agent.

## Headers

- `Request-Timeout` integer
- `Request-Timeout-Millis` integer

## Response `200`

The A2A v0.3 Agent Card describing this agent.

- A2aV03AgentCard — The A2A v0.3 Agent Card. Returned from `GET /v2/agents/{agent_key}/.well-known/agent-card.json` and `GET /v2/agents/{agent_key}/v1/card`. The card's `url` advertises the JSON-RPC, gRPC, or HTTP+JSON RPC endpoint per `preferredTransport`. `additionalInterfaces` lists other supported transports.
  - `protocolVersion` string — The version of the A2A protocol this agent supports (e.g. `0.3.0`).
  - `name` string, required — Human-readable name of the agent.
  - `description` string, required — Human-readable description of the agent.
  - `url` string, required — URL of the agent's preferred RPC endpoint.
  - `preferredTransport` string, nullable — Transport of the preferred endpoint. If empty, defaults to `JSONRPC`.
  - `additionalInterfaces` A2aV03AgentInterface[], nullable — Additional transport endpoints supported beyond `url`.
    - `url` string, required — URL of the transport endpoint.
    - `transport` string, required — Transport name. Open string; common values include `JSONRPC`, `GRPC`, `HTTP+JSON`.
  - `provider` A2aV03AgentProvider — Identifies the organization providing the agent.
    - `url` string, required — URL of the provider's website or homepage.
    - `organization` string, required — Name of the organization providing the agent.
  - `version` string, required — Version string of the agent implementation.
  - `documentationUrl` string, nullable — URL of the agent's documentation.
  - `capabilities` A2aV03AgentCapabilities, required — Capabilities the v0.3 agent advertises.
    - `streaming` boolean — True if the agent supports streaming responses via SSE.
    - `pushNotifications` boolean — True if the agent supports out-of-band push notifications.
    - `extensions` A2aV03AgentExtension[], nullable — Protocol extensions supported by the agent.
      - `uri` string, required — URI uniquely identifying the extension.
      - `description` string, nullable — Human-readable description of what the extension does.
      - `required` boolean — True if the client must understand this extension to interact with the agent.
      - `params` object, nullable — Extension-specific configuration parameters.
  - `securitySchemes` object, nullable — Security schemes the agent supports, keyed by scheme name.
  - `security` object[], nullable — Security requirements for the agent. Each entry maps scheme names to scope lists. Entries are alternatives. All schemes in one entry apply together.
  - `defaultInputModes` string[], required — Default media types the agent accepts as input across all skills.
  - `defaultOutputModes` string[], required — Default media types the agent produces as output across all skills.
  - `skills` A2aV03AgentSkill[], required — The skills the agent advertises.
    - `id` string, required — Unique identifier of the skill.
    - `name` string, required — Human-readable name of the skill.
    - `description` string, required — Human-readable description of what the skill does.
    - `tags` string[], nullable — Tags categorizing the skill for discovery.
    - `examples` string[], nullable — Example prompts or inputs demonstrating the skill.
    - `inputModes` string[], nullable — Media types the skill accepts as input.
    - `outputModes` string[], nullable — Media types the skill produces as output.
    - `security` object[], nullable — Security requirements for the skill. Each entry maps scheme names to scope lists. Entries are alternatives. All schemes in one entry apply together.
  - `supportsAuthenticatedExtendedCard` boolean — True if the agent serves an extended card requiring authentication.
  - `signatures` A2aV03AgentCardSignature[], nullable — JWS signatures over the agent card.
    - `protected` string, required — Base64url-encoded protected JOSE header.
    - `signature` string, required — Base64url-encoded signature.
    - `header` object, nullable — Unprotected JOSE header (free-form object).

## Other responses

- `404` — Agent not found.

---

[API](https://skmtc.net/vectara/apis/vectara-rest-api-v2.md) · [All operations](https://skmtc.net/vectara/apis/vectara-rest-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vectara/vectara-rest-api-v2/versions/e85040b266cc/schema)