---
title: "Get A2A v1 extended agent card"
method: GET
path: "/v2/agents/{agent_key}/extendedAgentCard"
tags: ["A2A Protocol"]
---

# Get A2A v1 extended agent card

`GET /v2/agents/{agent_key}/extendedAgentCard`

Returns the v1 [Agent Card](https://a2a-protocol.org) for authenticated callers. The response body is identical to the well-known 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 v1 Agent Card.

- A2aV1AgentCard — The A2A v1 Agent Card. The card lists every transport endpoint in `supportedInterfaces`. The first entry is the preferred binding.
  - `name` string, required — Human-readable name of the agent.
  - `description` string, required — Human-readable description of the agent.
  - `supportedInterfaces` A2aV1AgentInterface[], required — All transport endpoints supported by the agent; the first entry is the preferred binding.
    - `url` string, required — URL of this transport endpoint.
    - `protocolBinding` string, required — The transport binding for this interface. Open string; one of `JSONRPC`, `GRPC`, or `HTTP+JSON`.
    - `tenant` string, nullable — Tenant identifier substituted into the URL on requests.
    - `protocolVersion` string, required — A2A protocol version this interface exposes (e.g. `0.3`, `1.0`).
  - `provider` A2aV1AgentProvider — Identifies the organization providing the v1 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` A2aV1AgentCapabilities, required — Optional capabilities the v1 agent supports, such as streaming and the extended agent card.
    - `streaming` boolean, nullable — True if the agent supports streaming responses via SSE.
    - `pushNotifications` boolean, nullable — True if the agent supports out-of-band push notifications.
    - `extensions` A2aV1AgentExtension[], 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.
    - `extendedAgentCard` boolean, nullable — True if the agent serves an extended card requiring authentication.
  - `securitySchemes` object, nullable — Security schemes the agent supports, keyed by scheme name.
  - `securityRequirements` 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` A2aV1AgentSkill[], 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[], required — 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.
    - `securityRequirements` 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.
  - `signatures` A2aV1AgentCardSignature[], 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).
  - `iconUrl` string, nullable — URL of the agent's icon image.

## 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)