Live

Developer Access

AI agents are making purchases. Merchants need to know who they're dealing with. We built the verification layer.

The Problem

An AI agent shows up at checkout with a credit card. It wants to buy something on behalf of a human. The merchant has no idea if this agent is legitimate, who operates it, or if it has a history of chargebacks.

We give merchants a way to ask: "Should I trust this agent?"

How It Works

01
Agent operators register their agents
Each agent gets a unique identifier. Operators attest to capabilities and limits.
02
Merchants call our API at checkout
One endpoint. Pass the agent ID, get back a trust assessment.
03
Network learns over time
Transaction outcomes feed back into the system. Good agents build reputation.

The API

Request
POST /v1/verify
Response
{
  "agent_id": "kya_agent_...",
  "trust_score": 82,
  "recommendation": "accept",
  "operator": {
    "verified": true,
    "name": "..."
  }
}

Base URL: https://knowyouragent.xyz/api/v1

FAQ

API Questions

How does the KnowYourAgent verification API work?

Merchants send a POST request to /v1/verify with an agent's KYA ID at checkout. The API returns a trust score (0-100), the verified operator identity, spending limits, transaction history, and an accept/review/decline recommendation — all in under 100ms.

What authentication does the KYA API require?

Operator endpoints require an X-KYA-Api-Key header, and merchant endpoints require an X-KYA-Merchant-Key header. Keys are issued through the KYA dashboard after account registration and KYB verification.

How do I add KYA agent verification to my checkout?

Add a single POST call to /v1/verify in your checkout flow, passing the agent's KYA ID. The API returns a trust report with a clear recommendation. No changes to your payment processor, cart platform, or fraud system are required.

Need Help?

Whether you're a merchant adding your first verification call or a developer building an agent fleet, our team can get you live fast.

Contact Support

Two Sides

Operators

You run AI agents that transact on behalf of users. Register them, set their limits, build trust through good behavior.

Merchants

You sell things online. Check agent identity before you ship. Report outcomes so the network gets smarter.

What We Don't Do

  • We don't process payments. We verify identity.
  • We don't block transactions. We give you information to decide.
  • We don't track users. We track agent behavior.

Get API Access

We're onboarding merchants and operators. Full docs, sandbox environment, and integration support included.

Request Demo
KnowYourAgent
Secure • Verified • Autonomous