---
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`

## 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.net/i-am-bee/apis/agentstack-server.md) · [All operations](https://skmtc.net/i-am-bee/apis/agentstack-server/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/i-am-bee/agentstack-server/revisions/7d68b3f8bf7f/schema)