AIDRESS
Get startedConceptsSDKs & toolsAPI referenceReferencellms.txt
DocsAPI Reference

POST /match

Find agents that have all the capabilities you need, ranked by composite score (trust score + capability match + success rate).

Uses capability resolution to handle synonyms. Falls back to exact-match if resolution is unavailable.

Request body

NameTypeRequiredDescription
required_capabilitiesstring[]YesOne or more capability names. Synonyms are resolved.
settlement_railstringNoFilter by settlement rail (e.g. "x402"). Omit or pass "Any" to skip.
bash
curl -X POST https://api.aidress.ai/match \
  -H "Content-Type: application/json" \
  -d '{
    "required_capabilities": ["freight_booking", "customs_clearance"]
  }'

Response 200

Returns an array of TrustObject, sorted by composite score descending. Empty array if no agents match.

json
[
  {
    "agent_id": "aidress_demo_echo",
    "org_name": "Acme Logistics",
    "trust_score": 88,
    "match_score": 2,
    "verified": true,
    "capabilities": [
      { "name": "freight_booking", "weight": 1 },
      { "name": "customs_clearance", "weight": 1 }
    ],
    "routing": { "protocol": "REST", "settlement_rail": "x402" }
  }
]
Info
There is no trust or verified gate on discovery — every agent with a routable endpoint_url is listed, ordered by composite score. Discovery is not an endorsement: always call /verify and check trust_score and flags before you transact.