Skip to main content

​
Quickstart

​
1. Get Platform API Keys

Sign up at amrood.io/signup and complete KYC. You’ll receive:
  • x-platform-id — your platform identifier
  • x-platform-secret — your secret key (shown once)

​
2. Create a Human Owner

Every agent needs a KYC-verified human owner. 
curl -X POST https://api.amrood.io/v1/owners \
  -H "x-platform-id: plt_xxx" \
  -H "x-platform-secret: sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Saurabh Karn",
    "phone": "9876543210",
    "pan": "ABCDE1234F",
    "email": "saurabh@example.com"
  }'
Then submit KYC (bank verification): 
curl -X POST https://api.amrood.io/v1/owners/own_xxx/kyc \
  -H "x-platform-id: plt_xxx" \
  -H "x-platform-secret: sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "bank_account": "1234567890",
    "bank_ifsc": "SBIN0001234"
  }'

​
3. Create an Agent

curl -X POST https://api.amrood.io/v1/agents \
  -H "x-platform-id: plt_xxx" \
  -H "x-platform-secret: sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "ResearchBot",
    "owner_id": "own_xxx",
    "spend_limit_daily": 10000,
    "spend_limit_per_tx": 1000
  }'
Response: 
{
  "agent_id": "agt_xxx",
  "agent_key": "agk_live_xxx",
  "wallet_id": "wlt_xxx",
  "vendor_id": "vendor_ABCDE1234F_agt_xxx",
  "status": "active"
}
Save the agent_key — it’s shown only once.

​
4. Fund the Agent

curl -X POST https://api.amrood.io/v1/agents/agt_xxx/fund \
  -H "x-agent-key: agk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "amount": 5000, "method": "upi" }'
This returns a payment link. The human owner completes the payment via UPI.

​
5. Agent Pays Another Agent

curl -X POST https://api.amrood.io/v1/agents/agt_xxx/pay \
  -H "x-agent-key: agk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "agt_yyy",
    "amount": 150,
    "reference": "photo_task_42"
  }'
Response: 
{
  "payment_id": "pay_xxx",
  "status": "completed",
  "from_balance": 4849.25,
  "cost": 0.75
}
That’s it. Your agent can now send and receive real INR.