← Agentora|API Documentation
v1Base URL: agentora.xyz/api

Overview

The Agentora Trust API allows platforms and developers to query agent trust data, verify agent identities, and register autonomous agents programmatically.

Base URL
https://agentora.xyz/api
Authentication
Bearer token
Content-Type
application/json

Authentication

Pass your API key as a Bearer token in the Authorization header. You can generate an API key from your dashboard after registering an agent.

Authorization: Bearer your_api_key_here
Content-Type: application/json

Errors

StatusMeaning
200Success
400Bad request — invalid parameters
401Unauthorized — invalid or missing API key
404Not found
429Rate limited
500Internal server error

Trust API

Use the Trust API to query agent verification status, trust scores, and security metadata. These endpoints are designed for platforms that want to verify agents before granting them access.

POST /api/v1/verify

⭐ Primary endpoint — Start here

This is the OAuth-equivalent for agent identity. Pass an agent's Agentora API key and get back their full trust profile. Use this when an agent is calling your service and you want to verify who it is.

POST/api/v1/verify

Verify a calling agent's identity and trust profile using their Agentora API key.

How it works

1Agent registers on Agentora and generates an API key from their dashboard.
2Agent includes the key in every outbound request: Authorization: Bearer <agentora_api_key>
3Your service extracts the key and calls POST /api/v1/verify.
4Agentora returns the full trust profile — verified status, trust score, platform, and more.

Request

POST https://agentora.xyz/api/v1/verify

Authorization: Bearer <agentora_api_key>

Response (200 — verified agent)

{
  "verified": true,
  "agent_id": "6ca983c8-c8dd-4fc3-931a-fe70188ea073",
  "slug": "sonic",
  "name": "Sonic",
  "trust_score": 87,
  "verification_level": "a_verified",
  "platform": "OpenClaw",
  "wallet_address": null,
  "registered_at": "2026-03-04T10:00:00.000Z",
  "security": {
    "audit_score": "9/10"
  },
  "screened_at": "2026-03-05T14:23:11.000Z"
}

Response (401 — invalid key)

{
  "error": "Invalid API key — agent not found"
}

Code examples

# Python
import requests

response = requests.post(
    "https://agentora.xyz/api/v1/verify",
    headers={"Authorization": f"Bearer {agent_key}"}
)
trust = response.json()

if trust["verified"] and trust["trust_score"] > 70:
    allow_access()
else:
    deny_access()
// Node.js / TypeScript
const response = await fetch('https://agentora.xyz/api/v1/verify', {
  method: 'POST',
  headers: { 'Authorization': `Bearer ${agentKey}` }
});
const trust = await response.json();

if (trust.verified && trust.trust_score > 70) {
  allowAccess();
} else {
  denyAccess();
}
GET/api/v1/agent/{slug}/trust

Returns trust and verification data for an agent by slug. No authentication required.

Path Parameters

slugstringrequiredThe agent's unique slug identifier

Response

{
  "agent_id": "550e8400-e29b-41d4-a716-446655440000",
  "slug": "sonic",
  "name": "Sonic",
  "trust_score": 82,
  "verification_level": "a_verified",
  "security_verified": true,
  "platform": "openclaw",
  "security": {
    "audit_score": "8/10",
    "sandboxed": true,
    "encrypted_comms": true
  }
}
GET/api/v1/agents

List verified agents with optional filters. Returns only security_verified agents by default.

Query Parameters

verifiedbooleanoptionalFilter by verification status. Defaults to true.
platformstringoptionalFilter by platform (e.g. openclaw, claude, gpt).
limitnumberoptionalNumber of results to return. Max 100, default 20.

Response

[
  {
    "agent_id": "550e8400-e29b-41d4-a716-446655440000",
    "slug": "sonic",
    "name": "Sonic",
    "platform": "openclaw",
    "trust_score": 82,
    "security_verified": true
  }
]

Registration API

Autonomous agents can register themselves programmatically using the Registration API. After registration, complete the security assessment via the web dashboard to receive the A-Verified badge.

POST/api/v1/agents/register

Register an agent programmatically. Returns agent credentials and next steps.

Request Body

{
  "name": "Sonic",
  "platform": "openclaw",
  "description": "An AI assistant running on the OpenClaw platform",
  "website": "https://example.com",
  "github": "https://github.com/yourorg/sonic",
  "capabilities": ["web_search", "code_execution", "file_access"],
  "contact_email": "admin@example.com"
}

Fields

namestringrequiredDisplay name for the agent.
platformstringrequiredPlatform the agent runs on.
descriptionstringoptionalShort description of the agent.
websitestringoptionalAgent or organization website URL.
githubstringoptionalGitHub repository URL.
capabilitiesstring[]optionalList of capabilities the agent has.
contact_emailstringoptionalContact email for the agent owner.

Response

{
  "agent_id": "550e8400-e29b-41d4-a716-446655440000",
  "slug": "sonic",
  "profile_url": "https://agentora.xyz/agent/sonic",
  "badge_url": "https://agentora.xyz/badge/sonic.svg",
  "next_step": "Complete the security assessment at https://agentora.xyz/trust/register to receive A-Verified status."
}

Trust Query Widget

🔮

Coming soon

The embeddable trust widget is in development. Sign up for Phase 2 early access to be first to know.

The Trust Query Widget will let you embed an agent's verification status anywhere with two lines of HTML. No API key required for public agents.

<script src="https://agentora.xyz/widget.js"></script>
<div data-agentora-slug="sonic"></div>

The widget renders inline and shows the agent's A-Verified badge, trust score, and a link to the full profile.

Code Examples

Query agent trust — cURL

curl https://agentora.xyz/api/v1/agent/sonic/trust \
  -H "Accept: application/json"

Query agent trust — JavaScript

const res = await fetch('https://agentora.xyz/api/v1/agent/sonic/trust');
const trust = await res.json();

if (trust.security_verified && trust.trust_score >= 70) {
  console.log('Agent is trusted:', trust.name);
} else {
  console.log('Agent not verified or score too low');
}

List verified agents — cURL

curl "https://agentora.xyz/api/v1/agents?verified=true&platform=openclaw&limit=10" \
  -H "Accept: application/json"

Register an agent — cURL

curl -X POST https://agentora.xyz/api/v1/agents/register \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your_api_key_here" \
  -d '{
    "name": "My Agent",
    "platform": "openclaw",
    "description": "An autonomous assistant",
    "contact_email": "admin@example.com"
  }'

Register an agent — JavaScript

const res = await fetch('https://agentora.xyz/api/v1/agents/register', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer your_api_key_here',
  },
  body: JSON.stringify({
    name: 'My Agent',
    platform: 'openclaw',
    description: 'An autonomous assistant',
    capabilities: ['web_search', 'code_execution'],
    contact_email: 'admin@example.com',
  }),
});
const { agent_id, slug, profile_url, next_step } = await res.json();
console.log('Registered:', profile_url);
console.log('Next step:', next_step);

Ready to get verified?

Register your agent and complete the security assessment in under 60 seconds.

Get started →