---
title: "Get Agent Card"
method: GET
path: "/api/v1/a2a/{provider_id}/.well-known/agent-card.json"
tags: ["a2a"]
---

# Get Agent Card

`GET /api/v1/a2a/{provider_id}/.well-known/agent-card.json`

## Request

- The document declares no server URL.
- Auth: one of:
  - HTTP basic
  - HTTP bearer

## Path parameters

- `provider_id` string, uuid, required

## Response `200`

Successful Response

- AgentCardOutput: The AgentCard is a self-describing manifest for an agent. It provides essential metadata including the agent's identity, capabilities, skills, supported communication methods, and security requirements.
  - `additionalInterfaces` AgentInterface[], nullable
    - `transport` string, required
    - `url` string, required
  - `capabilities` AgentCapabilities, required: Defines optional capabilities supported by an agent.
    - `extensions` AgentExtension[], nullable
      - `description` string, nullable
      - `params` object, nullable
      - `required` boolean, nullable
      - `uri` string, required
    - `pushNotifications` boolean, nullable
    - `stateTransitionHistory` boolean, nullable
    - `streaming` boolean, nullable
  - `defaultInputModes` string[], required
  - `defaultOutputModes` string[], required
  - `description` string, required
  - `documentationUrl` string, nullable
  - `iconUrl` string, nullable
  - `name` string, required
  - `preferredTransport` string, nullable
  - `protocolVersion` string, nullable
  - `provider` AgentProvider: Represents the service provider of an agent.
    - `organization` string, required
    - `url` string, required
  - `security` object[], nullable
  - `securitySchemes` object, nullable
  - `signatures` AgentCardSignature[], nullable
    - `header` object, nullable
    - `protected` string, required
    - `signature` string, required
  - `skills` AgentSkill[], required
    - `description` string, required
    - `examples` string[], nullable
    - `id` string, required
    - `inputModes` string[], nullable
    - `name` string, required
    - `outputModes` string[], nullable
    - `security` object[], nullable
    - `tags` string[], required
  - `supportsAuthenticatedExtendedCard` boolean, nullable
  - `url` string, required
  - `version` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/i-am-bee/apis/agentstack-server.md) - [All operations](https://skmtc.dev/i-am-bee/apis/agentstack-server/llms.txt) - [OpenAPI document](https://skmtc.dev/i-am-bee/apis/agentstack-server/revisions/7d68b3f8bf7f?raw)