Python
import httpx
card = httpx.get(
"https://api.onecortex.io/v1/agents/agt_.../a2a/.well-known/agent-card.json",
headers={"A2A-Version": "1.0"},
).json()
print(card["name"], [skill["name"] for skill in card["skills"]])
const response = await fetch('https://api.onecortex.io/v1/agents/agt_.../a2a/.well-known/agent-card.json', {
headers: { 'A2A-Version': '1.0' },
})
const card = await response.json()
console.log(card.name, card.skills.map((skill) => skill.name))
curl https://api.onecortex.io/v1/agents/agt_.../a2a/.well-known/agent-card.json -H "A2A-Version: 1.0"
{
"name": "market-researcher",
"description": "Researches markets and returns a sourced summary.",
"version": "3",
"supportedInterfaces": [
{
"url": "https://api.onecortex.io/v1/agents/agt_01K0000000000000000000000/a2a",
"protocolBinding": "JSONRPC",
"protocolVersion": "1.0"
},
{
"url": "https://api.onecortex.io/v1/agents/agt_01K0000000000000000000000/a2a",
"protocolBinding": "JSONRPC",
"protocolVersion": "0.3"
}
],
"provider": {
"organization": "Onecortex",
"url": "https://onecortex.io"
},
"capabilities": {
"streaming": true,
"pushNotifications": false
},
"defaultInputModes": [
"text/plain"
],
"defaultOutputModes": [
"text/plain"
],
"skills": [
{
"id": "market-research",
"name": "market-research",
"description": "Compare vendors in a market segment.",
"tags": [
"research"
],
"examples": []
}
]
}{
"error": {
"code": "validation_failed",
"message": "<string>",
"requestId": "<string>",
"details": {}
}
}{
"error": {
"code": "validation_failed",
"message": "<string>",
"requestId": "<string>",
"details": {}
}
}Endpoints
Read an agent's A2A Agent Card
The public card another agent reads to discover yours: its name, description, skills, A2A URL and how to authenticate. No key needed. With A2A-Version: 1.0 the card is in the 1.0 shape; without it, the 0.3 shape.
The same card is served at /v1/agents/{agentId}/.well-known/agent-card.json. A deleted, suspended or never deployed agent answers 404, the same as one that does not exist. See A2A.
GET
/
v1
/
agents
/
{agentId}
/
a2a
/
.well-known
/
agent-card.json
Python
import httpx
card = httpx.get(
"https://api.onecortex.io/v1/agents/agt_.../a2a/.well-known/agent-card.json",
headers={"A2A-Version": "1.0"},
).json()
print(card["name"], [skill["name"] for skill in card["skills"]])
const response = await fetch('https://api.onecortex.io/v1/agents/agt_.../a2a/.well-known/agent-card.json', {
headers: { 'A2A-Version': '1.0' },
})
const card = await response.json()
console.log(card.name, card.skills.map((skill) => skill.name))
curl https://api.onecortex.io/v1/agents/agt_.../a2a/.well-known/agent-card.json -H "A2A-Version: 1.0"
{
"name": "market-researcher",
"description": "Researches markets and returns a sourced summary.",
"version": "3",
"supportedInterfaces": [
{
"url": "https://api.onecortex.io/v1/agents/agt_01K0000000000000000000000/a2a",
"protocolBinding": "JSONRPC",
"protocolVersion": "1.0"
},
{
"url": "https://api.onecortex.io/v1/agents/agt_01K0000000000000000000000/a2a",
"protocolBinding": "JSONRPC",
"protocolVersion": "0.3"
}
],
"provider": {
"organization": "Onecortex",
"url": "https://onecortex.io"
},
"capabilities": {
"streaming": true,
"pushNotifications": false
},
"defaultInputModes": [
"text/plain"
],
"defaultOutputModes": [
"text/plain"
],
"skills": [
{
"id": "market-research",
"name": "market-research",
"description": "Compare vendors in a market segment.",
"tags": [
"research"
],
"examples": []
}
]
}{
"error": {
"code": "validation_failed",
"message": "<string>",
"requestId": "<string>",
"details": {}
}
}{
"error": {
"code": "validation_failed",
"message": "<string>",
"requestId": "<string>",
"details": {}
}
}Last modified on September 29, 2026