Developer Documentation
API Reference
Everything you need to integrate KnowYourAgent verification into your application.
How It Works
[1]
Agent Request
Agent sends checkout request with KYA ID.
[2]
Merchant Verifies
Merchant calls /v1/verify to check the agent.
[3]
Get Response
Receive trust score and transaction history.
[4]
Make Decision
Accept, review, or decline based on score.
BASE_URL: https://api.knowyouragent.xyz/v1
[AI Agent] → [ACP Payload] → [Merchant]
↓↓↓
Query /v1/verify?id=kya_agent_...
↓↓↓
{ trust_score: 87, recommendation: 'accept' }
For Operators
Register and manage your AI agents.
For Merchants
Verify agents before accepting transactions.
For Platforms
Integrate verification into your checkout.
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"
}Need Help?
Our team is available to help with integration questions and custom implementations.