Docs · Sellers

Seller check API in 5 minutes

Four calls: check a Bond, reserve pay later, settle when paid, and file a claim if the agent doesn't pay. All examples are copy-paste curl.

Note: these endpoints answer once Bonds are public. Until then every /api/bond route returns 404 {"error":"not_found"}.

1. Check a Bond

No key needed. Pass the Bond id the agent gives you and the amount in US dollars.

curl "https://agentics.you/api/bond/BOND_ID/check?amount=12.50"

Example response (trimmed):

{
  "bonded": true,
  "owner": { "label": "Verified person" },
  "limit": "250",
  "available": "250",
  "pay_later_ok": true,
  "pay_later_on": true,
  "bond_id": "3f8e047a-09cc-4dc5-826e-bbbfdd0447a8",
  "as_of": "2026-10-02T19:00:00.000Z",
  "mode_label": "Locked",
  ...
}
FieldMeaning
bondedThe agent has an active Bond.
owner.labelWho owns it, for example “Verified person”.
availableWhat it can spend right now, in USD. Backed by money the owner keeps on hand, checked on-chain before every purchase.
pay_later_okThis amount can be paid later right now.
as_ofWhen the answer was computed. Check again before each purchase.

Errors: 400 bad_amount, 404 not_found (no such Bond).

2. Reserve pay later

The agent sends a short-lived Bond token in the Agentics-Bond header. Pass it on with your Agentics API key. The amount is reserved against the Bond until the agent pays.

curl -X POST "https://agentics.you/api/bond/BOND_ID/authorize" \
  -H "Authorization: Bearer $AGENTICS_API_KEY" \
  -H "Agentics-Bond: $BOND_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"amount":"12.50","due_at":"2026-10-03T19:00:00Z","payee":"shop.example","resource":"https://shop.example/report"}'

Example response:

{
  "id": "AUTHORIZATION_ID",
  "status": "open",
  "amount": "12.5",
  "due_at": "2026-10-03T19:00:00.000Z",
  "available": "237.5",
  "receipt_hash": "…",
  "bond_id": "BOND_ID"
}

Anything other than 200 means: take payment the normal way. Common answers: 401 unauthorized, 403 seller_required, 403 rules_denied, 409 over_available, 409 token_replayed, 423 paused (the owner paused the agent).

Optional: verify the token yourself before you call. It is signed with EdDSA, the keys are at /.well-known/jwks.json, and the audience is your domain.

3. Settle when the agent pays

curl -X POST "https://agentics.you/api/bond/BOND_ID/authorizations/AUTHORIZATION_ID/settle" \
  -H "Authorization: Bearer $AGENTICS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Returns {"id": "…", "status": "settled", "receipt_hash": "…", "bond_id": "…"}. Errors: 403 wrong_seller, 409 not_open.

4. If the agent doesn't pay: file an Unpaid claim

After the due date, if the reserve is still open:

curl -X POST "https://agentics.you/api/bond/BOND_ID/claims" \
  -H "Authorization: Bearer $AGENTICS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"authorization_id":"AUTHORIZATION_ID"}'

The owner has 72 hours to pay or explain. If the claim stands, it is settled from the Bond under the Bond terms. A claim that does not qualify (for example, before the due date) returns 422 claim_rejected with the reason. Claims are rate limited (429 rate_limited).

Before you start

  • Your Agentics account needs an active seller profile: your business name and a verified domain, and the seller terms accepted.
  • Use the API key from your Agentics account as AGENTICS_API_KEY. Keep it on your server.
  • Questions? Write to hello@agentics.you.

Read next