---
title: "Get Agent Card (Orchestrate)"
method: GET
path: "/well-known/agent-card.json"
tags: ["WellKnown"]
---

# Get Agent Card (Orchestrate)

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

## Request

- The document declares no server URL.
- Auth: none declared

## Response `200`

The Agent Card.

- AgentCard: Represents an A2A Agent Card.
  - `name` string
  - `description` string
  - `version` string
  - `protocolVersion` string
  - `provider` AgentProvider: Provider of an A2A agent.
    - `organization` string
    - `url` string
  - `capabilities` AgentCapabilities: Capabilities of an A2A agent.
    - `streaming` boolean
    - `pushNotifications` boolean
    - `extendedAgentCard` boolean
    - `extensions` AgentExtension[]
      - `uri` string
      - `description` string
      - `required` boolean
      - `params` object
  - `skills` AgentSkill[]
    - `id` string
    - `name` string
    - `description` string
    - `tags` string[]
    - `examples` string[]
    - `inputModes` string[]
    - `outputModes` string[]
    - `securityRequirements` AgentSecurityRequirement[]
      - `schemes` object
  - `defaultInputModes` string[]
  - `defaultOutputModes` string[]
  - `supportedInterfaces` AgentInterface[]
    - `url` string
    - `protocolBinding` string
    - `protocolVersion` string
    - `tenant` string
  - `securitySchemes` object
  - `securityRequirements` AgentSecurityRequirement[]
    - `schemes` object
  - `iconUrl` string
  - `documentationUrl` string
  - `signatures` AgentCardSignature[]
    - `protected` string
    - `signature` string
    - `header` object

## Other responses

- `401`: Common response for all operations that can return a `401` error indicating authentication is required.
- `403`: Common response for all operations that can return a `403` error indicating the user is authenticated but not authorized.
- `500`: Common response for all operations that can fail with an unexpected server error.

## Changes

- **2026-10-31** `ff9684af2aad`: 15 info
  - added the optional property `ruleViolation/causes/items/code` to the response with the `401` status
  - added the optional property `ruleViolation/causes/items/code` to the response with the `403` status
  - added the optional property `ruleViolation/causes/items/code` to the response with the `500` status
  - added the optional property `ruleViolation/causes/items/direction` to the response with the `401` status
  - …11 more
- **2026-10-29** `f17f5df4e79c`: 3 info
  - added the optional property `ruleViolation` to the response with the `401` status
  - added the optional property `ruleViolation` to the response with the `403` status
  - added the optional property `ruleViolation` to the response with the `500` status
- **2026-07-30** `aabaa7968ec3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/apicurio/apis/apicurio-registry-api-v3/changes/well-known/agent-card.json/get.md)

---

[API](https://skmtc.dev/apicurio/apis/apicurio-registry-api-v3.md) - [All operations](https://skmtc.dev/apicurio/apis/apicurio-registry-api-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/apicurio/apis/apicurio-registry-api-v3/revisions/ff9684af2aad?raw)