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": "did:hub:cortina",
  "status": "verified",
  "trust_tier": "certified",
  "trust_scores": {
    "composite": 0.78,
    "uptime": 0.92,
    "responsiveness": 0.85,
    "reliability": 0.71,
    "task_success": 0.80,
    "efficiency": 0.73,
    "volume": 0.65,
    "tool_accuracy": 0.88,
    "error_discipline": 0.70,
    "compliance": 0.95,
    "token_efficiency": 0.68,
    "behavioral_consistency": 0.82,
    "version_health": 0.90
  },
  "active_grants": 4,
  "enrolled_at": "2026-02-15T14:00:00Z",
  "last_seen": "2026-03-18T11:45:00Z",
  "last_attestation": "2026-03-18T06:00:00Z"
}
​
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

{
  "credential": {
    "@context": ["https://www.w3.org/ns/credentials/v2"],
    "type": ["VerifiableCredential", "TrustTierCredential"],
    "issuer": "did:hub:agentvault-platform",
    "credentialSubject": {
      "id": "did:hub:cortina",
      "trustTier": "certified"
    },
    "proof": { "type": "Ed25519Signature2020", "proofValue": "..." }
  }
}

​
Response

{
  "valid": true,
  "checks": [
    { "check": "signature", "passed": true },
    { "check": "issuer", "passed": true },
    { "check": "expiration", "passed": true },
    { "check": "revocation", "passed": true },
    { "check": "subject", "passed": true }
  ],
  "subject": "did:hub:cortina",
  "credential_type": "TrustTierCredential"
}

​
Resolve DID Document

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

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

​
Response

{
  "@context": "https://www.w3.org/ns/did/v1",
  "id": "did:hub:cortina",
  "verificationMethod": [
    {
      "id": "did:hub:cortina#owner-key-1",
      "type": "Ed25519VerificationKey2020",
      "controller": "did:hub:cortina",
      "publicKeyMultibase": "z6Mk..."
    },
    {
      "id": "did:hub:cortina#op-key-1",
      "type": "Ed25519VerificationKey2020",
      "controller": "did:hub:cortina",
      "publicKeyMultibase": "z6Mk..."
    }
  ],
  "authentication": ["did:hub:cortina#op-key-1"],
  "assertionMethod": ["did:hub:cortina#owner-key-1"],
  "service": [
    {
      "id": "did:hub:cortina#messaging",
      "type": "AgentVaultMessaging",
      "serviceEndpoint": "wss://api.agentvault.chat/ws"
    }
  ]
}

​
SDK Verification

For programmatic verification, use the @agentvault/verify package: 
import { resolveAgent, verifyCredential } from "@agentvault/verify";

// Quick identity check
const agent = await resolveAgent("cortina");
console.log(agent.trustTier);  // "certified"
console.log(agent.trustScore); // 0.78

// Full credential verification
const result = await verifyCredential(credential, {
  trustedIssuers: ["did:hub:agentvault-platform"],
});

npm install @agentvault/verify

​
Rate Limits

EndpointPublicAuthenticated
/verify/{hub_address}30/min300/min
/verify/credential30/min300/min
/hub/{address}/did60/min600/min
Authenticated requests use an API key in the X-API-Key header.