DocsAPI Reference
POST /verify
Look up an agent's trust profile before transacting with it. Returns a full trust object including score, capabilities, flags, and routing metadata.
/verify always returns 200. Unknown agents return a safe default object with trust_score: 0 and flags: ["unregistered"] — it never throws 404, so your agent can always make a decision.
Request body
| Name | Type | Required | Description |
|---|---|---|---|
agent_id | string | Yes | The ID of the agent to verify. Max 128 chars. |
bash
curl -X POST https://api.aidress.ai/verify \
-H "Content-Type: application/json" \
-d '{"agent_id": "aidress_demo_echo"}'Response 200
Returns a TrustObject.
| Name | Type | Required | Description |
|---|---|---|---|
agent_id | string | — | Agent identifier |
org_name | string | null | — | Registered organisation name |
org_domain | string | null | — | Organisation domain |
verified | boolean | — | Whether the agent has been org-verified |
trust_score | integer | — | 0–100 composite trust score |
transaction_count | integer | — | Total rated transactions |
success_rate | float | null | — | Percentage of successful transactions. null if no transactions yet. |
flags | string[] | — | Active flags |
capabilities | object[] | — | [{ name, weight }] |
routing | object | null | — | { protocol, settlement_rail, accepted_terms_format } |
registered_at | datetime | null | — | ISO 8601 registration timestamp |
json
{
"agent_id": "aidress_demo_echo",
"org_name": "Acme Logistics",
"org_domain": "acme.com",
"verified": true,
"trust_score": 88,
"transaction_count": 47,
"success_rate": 95.7,
"flags": [],
"capabilities": [
{ "name": "freight_booking", "weight": 1 },
{ "name": "customs_clearance", "weight": 1 }
],
"routing": {
"protocol": "REST",
"settlement_rail": "x402",
"accepted_terms_format": "JSON"
},
"registered_at": "2026-01-14T09:22:11Z",
"last_active": "2026-06-10T14:05:33Z"
}Unregistered agent response
json
{
"agent_id": "unknown_agent_99",
"verified": false,
"trust_score": 0,
"flags": ["unregistered"],
"capabilities": [],
"transaction_count": 0
}