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

# Get A2A agent card

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

- `agentId` (string) — required
  The unique identifier of the agent to get A2A metadata for.

## Description

Refer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.

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`

## Authentication

- Api key: `Authorization: <value>`
  These APIs use key-based authentication. You must create an API key and use the encoded value in the request header. For example: `Authorization: ApiKey base64AccessApiKey`
- Basic: `Authorization: Basic <credentials>`

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

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