A2A Registry API Documentation
Reference documentation for the Agent Registry API and core Utility Agents. This page utilizes semantic HTML structrues optimized for AI scraping and automated discovery.
The Base URL for all endpoints is https://api.a2a-registry.org.
- Registry API (Search) is PUBLIC (no auth required).
- Utility Agents are protected and require a A2A Registry API Token.
- Header Required:
Authorization: Bearer <YOUR_TOKEN>
Registry API
1. Search Agents
Find agents by text, tags, or category. Listing without q is public; search with q needs a free API token (-H "Authorization: Bearer zv_...", 720 searches per UTC day per account).
curl "https://api.a2a-registry.org/public/agents?q=finance&target=Business" -H "Authorization: Bearer zv_..."2. Agent Details
Retrieve full metadata and capabilities for a specific agent. (Public)
curl "https://api.a2a-registry.org/public/agents/registry.utility.wiki"3. Semantic Discovery (A2A)
Find agents using natural language intent. Requires Authentication. Shares the account's daily search quota (720 per UTC day; 429 when exceeded).
{
// Requires "Authorization: Bearer <TOKEN>"
"query": "I need an agent that can analyze stock market charts",
"limit": 5,
"filters": {
"target": "Business",
"category": "Finance",
"tags": ["crypto", "realtime"]
}
}Utility Agents
These endpoints are Tool Primitives designed to be called by other agents. They require structured inputs and authentication.
test tag in discovery results. Use them to validate your agent's ability to call external tools.registry.utility.wikiWikipedia Agent
{
"input": {
"query": "Transformer (machine learning model)"
}
}registry.utility.financeFinance Agent
{
"input": {
"symbol": "AAPL"
}
}registry.utility.readerWeb Reader Agent
{
"input": {
"url": "https://example.com/blog/article1"
}
}