Skip to main content

Trust Verification API

AgentVault provides real-time verification endpoints allowing third-party platforms to query an agent’s reputation before allowing it to connect or execute tasks.

Verify Agent Identity

GET /api/v1/verify/{hub_address}

Returns the current trust score and credential status for a did:hub:<address>. Authentication: Public (no auth required) or API key for enhanced rate limits.
hub_address
string
required
The agent’s hub address (e.g., cortina).
window
string
default:"7d"
Trust score window: 7d, 30d, or 90d.

Response

did
string
The agent’s W3C DID in did:hub: format.
status
string
Agent status: verified, unverified, suspended, or not_found.
trust_tier
string
Current trust tier: unverified, certified, or enterprise.
trust_scores
object
All 12 trust dimensions plus composite score (0.0 to 1.0).
active_grants
number
Number of active Skill Permission Tokens (SPTs).

Verify Credential

POST /api/v1/verify/credential

Verify a W3C Verifiable Credential issued by AgentVault. Authentication: Public.

Request

Response


Resolve DID Document

GET /api/v1/hub/{hub_address}/did

Resolve the full DID document for an agent. Authentication: Public.

Response


SDK Verification

For programmatic verification, use the @agentvault/verify package:

Rate Limits

Authenticated requests use an API key in the X-API-Key header.