---
title: "Discover the AI Shopping Agent"
method: GET
path: "/v1/a2a/{key}/{domain}/.well-known/agent-card.json"
tags: ["Agent to agent"]
---

# Discover the AI Shopping Agent

`GET /v1/a2a/{key}/{domain}/.well-known/agent-card.json`

## Request

- Base URL: `https://agent.cnstrc.com`
- URL: `https://agent.cnstrc.com/v1/a2a/{key}/{domain}/.well-known/agent-card.json`
- Auth: none required

Retrieve the A2A 1.0 agent card for a configured AI Shopping Agent domain using the protocol media type `application/a2a+json`. The card describes the product-discovery skill, supported input and output modes, bearer authentication, and the tenant-specific JSON-RPC interface URL. Discovery is public, but the card and authenticated `SendMessage` calls are both available only when A2A is enabled for the domain.

## Path parameters

- `key` string, required
- `domain` string, required

## Response `200`

A2A agent discovery document.

- A2AAgentCard: A2A discovery document describing how to invoke this AI Shopping Agent.
  - `name` string, required: Human-readable name of the agent.
  - `description` string, required: Human-readable description of the agent.
  - `version` string, required: Version of the agent implementation described by this card.
  - `provider` object: Organization that provides the agent.
    - `organization` string: Human-readable name of the organization providing the agent.
    - `url` string, uri: Public website of the organization providing the agent.
  - `documentationUrl` string, uri: Public documentation for integrating with the agent.
  - `supportedInterfaces` object[], required: Protocol interfaces through which the agent can be invoked.
    - `url` string, uri, required: Tenant-specific URL for invoking the agent.
    - `protocolBinding` 'JSONRPC', required: Transport binding used by the interface.
    - `protocolVersion` '1.0', required: A2A protocol version implemented by the interface.
  - `capabilities` object, required: A2A capabilities supported by the agent.
    - `streaming` false: Whether the agent supports streaming A2A responses.
    - `pushNotifications` false: Whether the agent supports A2A push notifications.
    - `extendedAgentCard` false: Whether an authenticated extended agent card is available.
  - `securitySchemes` object: Security scheme definitions supported by the agent, keyed by scheme name.
  - `securityRequirements` object[]: Security requirements callers must satisfy to invoke the agent.
  - `defaultInputModes` string[], required: Media types accepted by default for message parts.
  - `defaultOutputModes` string[], required: Media types produced by default for response parts.
  - `skills` A2AAgentSkill[], required: Tasks the agent advertises to A2A clients.
    - `id` string, required: Stable identifier for the advertised skill.
    - `name` string, required: Human-readable name of the skill.
    - `description` string, required: Human-readable description of what the skill does.
    - `tags` string[], required: Terms A2A clients can use to match the skill to a request.
    - `examples` string[]: Example shopper requests supported by the skill.
    - `inputModes` string[]: Media types the skill accepts for message parts.
    - `outputModes` string[]: Media types the skill can produce in response parts.

## Other responses

- `304`: The cached agent card is still current.
- `404`: The index or domain is unknown, A2A is not enabled for the domain, or public agent hosting is unavailable.
- `429`: Rate limit exceeded.

---

[API](https://skmtc.dev/constructor/apis/ai-shopping-agent.md) - [All operations](https://skmtc.dev/constructor/apis/ai-shopping-agent/llms.txt) - [OpenAPI document](https://skmtc.dev/constructor/apis/ai-shopping-agent/revisions/dbdbd16abddd?raw)