---
title: "Get the agent card"
method: GET
path: "/.well-known/agent.json"
tags: ["Agent Discovery"]
---

# Get the agent card

`GET /.well-known/agent.json`

The A2A standard discovery document. Any client that knows the
agent's base URL can `GET` this to learn the agent's DID,
capabilities, published skills, and where to send requests.

`OPTIONS` and `HEAD` are also accepted — useful for CORS
preflight and liveness probes respectively.

## Response `200`

Agent card

- AgentCard
  - `name` string, required
  - `description` string
  - `version` string, required — Agent's own version string.
  - `protocolVersion` string, required — A2A protocol version the agent speaks.
  - `did` string, required
  - `url` string, uri, required — Canonical URL where the agent serves requests.
  - `documentationUrl` string, uri
  - `defaultInputModes` string[]
  - `defaultOutputModes` string[]
  - `capabilities` object
    - `streaming` boolean — True when this agent supports `message/stream`. When false, that method returns `-32004`.
    - `pushNotifications` boolean
    - `stateTransitionHistory` boolean
  - `skills` SkillSummary[], required
    - `id` string, required — Stable identifier, e.g. `"pdf-summarize-v1"`.
    - `name` string, required — Human-readable display name.
    - `description` string, required
    - `tags` string[]
    - `version` string
  - `extensions` object[]
    - `name` string
    - `version` string
    - `description` string
  - `author` string
  - `tags` string[]

## Changes

- **2026-04-21** `8a22dc180044` — 2 breaking, 9 warning, 12 info
  - removed the required property `id` from the response with the `200` status
  - removed the required property `kind` from the response with the `200` status
  - removed the optional property `agentTrust` from the response with the `200` status
  - removed the optional property `capabilities/extensions` from the response with the `200` status
  - …19 more
- **2026-02-12** `970d68a5c55d` — 5 warning, 15 info
  - removed the optional property `capabilities/taskManagement` from the response with the `200` status
  - removed the optional property `did` from the response with the `200` status
  - removed the optional property `endpoints` from the response with the `200` status
  - removed the optional property `skills/items/description` from the response with the `200` status
  - …16 more

[Change history](https://skmtc.dev/getbindu/apis/bindu-agent-api/changes/.well-known/agent.json/get.md)

---

[API](https://skmtc.dev/getbindu/apis/bindu-agent-api.md) · [All operations](https://skmtc.dev/getbindu/apis/bindu-agent-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getbindu/bindu-agent-api/revisions/e070faa5425b/schema)