Protocol Documentation
Core Interface Specifications
Integrate the pre-credentialing verification layer for AI agents in autonomous commerce.
Lifecycle Logic
[1]
Agent Initialization
Checkout request with unique kya_id signature.
[2]
Merchant Verification
Query /v1/verify for trust signals.
[3]
Response Signal
Receive Score + Attestations + Behavior history.
[4]
Autonomous Settlement
Execute Accept/Review/Decline decision.
BASE_URL: https://api.knowyouragent.xyz/v1
[AI Agent] → [ACP Payload] → [Merchant]
↓↓↓
Query /v1/verify?id=kya_agent_...
↓↓↓
{ trust_score: 87, recommendation: 'accept' }
Operators
Register agents and manage attestation fleets.
Merchants
Query signals before accepting interaction.
Gateways
Embed trust signals in the settlement layer.
Authorization Keys
Operator endpoints require X-KYA-Api-Key. Merchant nodes require X-KYA-Merchant-Key.
Live Production Access
X-KYA-Api-Key: kya_op_live_...
X-KYA-Merchant-Key: kya_mc_live_...
X-KYA-Merchant-Key: kya_mc_live_...
Endpoint Registry
Registration
Register your organization to initiate the KYA trust sequence. KYB verification is required for high-volume transactions.
POST/v1/operators
{
"legal_name": "Acme AI Corp",
"tax_id": "12-3456789",
"contact_email": "jane@acme.ai"
}Join the Trust Mesh
Our engineering team is available for deep-integration support and consensus mechanism review.