Quickstart

From zero to your first verified transaction in five minutes. One call before money moves, then one call after to feed reputation.

1. Call assess before you transact

Send the counterparty agent (its A2A card URL or AgentFide id), the mandate you are acting under, and the action you intend.

curl

curl -X POST https://agentfide.com/v1/assess \
  -H "content-type: application/json" \
  -H "authorization: Bearer $AGENTFIDE_KEY" \
  -d '{
    "agent": "https://seller.example/.well-known/agent-card.json",
    "acting_for": {
      "principal": "acct_42",
      "mandate": { "limit": 500, "currency": "USD" }
    },
    "action": {
      "type": "purchase",
      "amount": 42,
      "currency": "USD",
      "counterparty": "seller_789"
    },
    "context": { "idempotency_key": "ord_abc123" }
  }'

TypeScript

// Minimal fetch wrapper — no SDK required.
const res = await fetch("https://agentfide.com/v1/assess", {
  method: "POST",
  headers: {
    "content-type": "application/json",
    authorization: `Bearer ${process.env.AGENTFIDE_KEY}`,
  },
  body: JSON.stringify({
    agent: "https://seller.example/.well-known/agent-card.json",
    acting_for: { principal: "acct_42", mandate: { limit: 500, currency: "USD" } },
    action: { type: "purchase", amount: 42, currency: "USD" },
    context: { idempotency_key: "ord_abc123" },
  }),
});

const trust = await res.json();
if (trust.decision === "allow") {
  // proceed with the transaction
}

2. Read the decision

You get a decision plus the four checks, an assessment_id, and an expiry. Proceed on allow, hold for a human or extra check on review, and stop on deny.

200 OK

{
  "decision": "allow",
  "identity":   { "card_verified": true, "operator": "Example Corp", "signature_method": "EdDSA" },
  "authority":  { "mandate_valid": true, "in_scope": true, "limit_remaining": 458 },
  "reputation": { "score": 740, "tier": "gold", "factors": { "...": 0 }, "explanation": "..." },
  "recourse":   { "available": true, "escrow_offered": true, "rewind_supported": true },
  "assessment_id": "ass_9f2c…",
  "expires_at": "2026-06-21T17:05:00.000Z"
}

3. Report the outcome

After the transaction, tell AgentFide what happened. This is the data loop that builds reputation, and it returns a signed, private by default receipt.

curl

curl -X POST https://agentfide.com/v1/outcome \
  -H "content-type: application/json" \
  -H "authorization: Bearer $AGENTFIDE_KEY" \
  -d '{ "assessment_id": "ass_9f2c…", "result": "paid", "amount": 42, "currency": "USD" }'

Preview behavior

Today assess performs live A2A card verification, mandate bounds checking, and a reputation score computed from reported outcomes. Recourse (escrow + Agent Rewind) is not yet offered, so decisions stay conservative. The request and response shapes above are stable.

Full assess reference →