---
type: api
title: Get A2A agent card
description: **Spaces method and path for this operation:**
url: https://www.elastic.co/elastic/docs-builder/docs/4641/api/doc/kibana/v9/operation/operation-get-agent-builder-a2a-agentid-json
resource: https://www.elastic.co/elastic/docs-builder/docs/4641/api/doc/kibana/v9/operation/operation-get-agent-builder-a2a-agentid-json
products:
  - Kibana
---

# Get A2A agent card

Authentication: required

Availability: Experimental since 9.2

- Server: `https://{kibana_url}`

## Paths

- `GET` `/api/agent_builder/a2a/{agentId}.json`
- `GET` `/s/{space_id}/api/agent_builder/a2a/{agentId}.json`

#### Path parameters

- `space_id` (string) — optional
  An identifier for the space. If `space_id` is not provided in the URL, the default space is used. Refer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.
- `agentId` (string) — required
  The unique identifier of the agent to get A2A metadata for.

## Description

Get agent discovery metadata in JSON format. Use this endpoint to provide agent information for A2A protocol integration and discovery. To learn more about the Agent Builder A2A server, refer to the [A2A server documentation](https://www.elastic.co/docs/explore-analyze/ai-features/agent-builder/a2a-server).

## Required authorization

- Privileges: `agentBuilder:read`

## Response

Indicates a successful response

`application/json`

## Code examples

#### Console

```console
GET kbn://api/agent_builder/a2a/{agentId}.json
```

#### curl

```curl
curl \
  -X GET "${KIBANA_URL}/api/agent_builder/a2a/{agentId}.json" \
  -H "Authorization: ApiKey ${API_KEY}"
```

## Response examples

#### A2a agent card response

`application/json`

Example response card of Elastic AI Agent

```json
{
  "capabilities": {
    "pushNotifications": false,
    "stateTransitionHistory": false,
    "streaming": false
  },
  "defaultInputModes": [
    "text/plain"
  ],
  "defaultOutputModes": [
    "text/plain"
  ],
  "description": "Elastic AI Agent",
  "name": "Elastic AI Agent",
  "protocolVersion": "0.3.0",
  "provider": {
    "organization": "Elastic",
    "url": "https://elastic.co"
  },
  "securitySchemes": {
    "authorization": {
      "description": "Authentication token",
      "in": "header",
      "name": "Authorization",
      "type": "apiKey"
    }
  },
  "skills": [
    {
      "description": "A powerful tool for searching and analyzing data within your Elasticsearch cluster.",
      "examples": [],
      "id": "platform.core.search",
      "inputModes": [
        "text/plain",
        "application/json"
      ],
      "name": "platform.core.search",
      "outputModes": [
        "text/plain",
        "application/json"
      ],
      "tags": [
        "tool"
      ]
    }
  ],
  "supportsAuthenticatedExtendedCard": false,
  "url": "http://localhost:5601/api/agent_builder/a2a/elastic-ai-agent",
  "version": "0.1.0"
}
```