{"openapi":"3.0.3","info":{"title":"Trusgent Trust API","version":"2026-05-01","description":"Agent-readable API for verifying Trusgent IDs, Trust Scores, Agent-readiness, public Trust Passports, and Agent Preview data."},"servers":[{"url":"https://www.trusgent.com"}],"paths":{"/api/v1/verify":{"get":{"summary":"Verify a Trusgent ID","parameters":[{"name":"trusgentId","in":"query","required":true,"schema":{"type":"string","example":"TG-S-839201"}}],"responses":{"200":{"description":"Verification status","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyResponse"}}}}}}},"/api/v1/trusgents/{id}":{"get":{"summary":"Fetch an Agent-readable Trust Passport","security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/TrusgentIdentifier"}],"responses":{"200":{"description":"Agent-readable profile","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrusgentProfile"}}}},"404":{"description":"Trusgent not found"}}}},"/api/v1/trusgents/{id}/trust-score":{"get":{"summary":"Fetch Trust Score and score breakdown","security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/TrusgentIdentifier"}],"responses":{"200":{"description":"Trust Score response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrustScoreResponse"}}}}}}},"/api/v1/search":{"get":{"summary":"Search trusted public profiles","security":[{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","schema":{"type":"string"}},{"name":"country","in":"query","schema":{"type":"string"}},{"name":"type","in":"query","schema":{"type":"string","enum":["PERSONAL","COMPANY","SERVICE_PROVIDER","PRODUCT","AI_AGENT"]}},{"name":"agentReady","in":"query","schema":{"type":"boolean"}}],"responses":{"200":{"description":"Search results","content":{"application/json":{"schema":{"type":"object","properties":{"results":{"type":"array","items":{"$ref":"#/components/schemas/SearchResult"}},"apiVersion":{"type":"string"}}}}}}}}},"/api/v1/agent-preview/{id}":{"get":{"summary":"Fetch structured AI Agent Preview data","security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/TrusgentIdentifier"}],"responses":{"200":{"description":"Agent Preview","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentPreview"}}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API Key"}},"parameters":{"TrusgentIdentifier":{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Internal record ID or public Trusgent ID."}},"schemas":{"VerifyResponse":{"type":"object","properties":{"valid":{"type":"boolean"},"status":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"trustScore":{"type":"integer","minimum":0,"maximum":100},"agentReadinessScore":{"type":"integer","minimum":0,"maximum":100},"verificationLevel":{"type":"string"}}},"TrusgentProfile":{"type":"object","properties":{"trusgentId":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"country":{"type":"string"},"city":{"type":"string"},"website":{"type":"string"},"headline":{"type":"string"},"agentSummary":{"type":"string"},"capabilities":{"type":"array","items":{"type":"string"}},"idealUseCases":{"type":"array","items":{"type":"string"}},"trustScore":{"type":"integer"},"agentReadinessScore":{"type":"integer"},"verificationLevel":{"type":"string"},"trustSignals":{"type":"array","items":{"type":"string"}},"riskSignals":{"type":"array","items":{"type":"string"}},"services":{"type":"array","items":{"type":"object"}},"reviewsSummary":{"type":"object"},"updatedAt":{"type":"string","format":"date-time"},"apiVersion":{"type":"string"}}},"TrustScoreResponse":{"type":"object","properties":{"trustScore":{"type":"integer"},"scoreBreakdown":{"type":"array","items":{"type":"object"}},"verificationLevel":{"type":"string"},"updatedAt":{"type":"string","format":"date-time"}}},"SearchResult":{"type":"object","properties":{"trusgentId":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"country":{"type":"string"},"city":{"type":"string"},"headline":{"type":"string"},"trustScore":{"type":"integer"},"agentReadinessScore":{"type":"integer"},"verificationLevel":{"type":"string"},"url":{"type":"string"}}},"AgentPreview":{"type":"object","properties":{"aiSummary":{"type":"string"},"bestUseCases":{"type":"array","items":{"type":"string"}},"coreCapabilities":{"type":"array","items":{"type":"string"}},"trustSignals":{"type":"array","items":{"type":"string"}},"potentialRiskSignals":{"type":"array","items":{"type":"string"}},"recommendedTasks":{"type":"array","items":{"type":"string"}},"notSuitableFor":{"type":"array","items":{"type":"string"}}}}}}}