{"uid":"cap_ZLdIjEurPz8cVTRVp501U","slug":"kya-brasil-agent-mandate-credential-allowance-check-f6b8e1d2","name":"KYA Brasil – Agent Mandate & Credential Allowance Check","description":"Signed verdict: is this action (action, amount, currency, counterparty, payment instrument) inside the agent's mandate and is the credential active? Evaluates the reserved mandate fields; lists the fields it did not evaluate.","url":"https://kya-br-agents.marcelfons.workers.dev/v1/agents/:id/allowed?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object","required":["id"],"properties":{"id":{"type":"string","description":"credential_id returned by POST /v1/agents"}}},"queryParams":{"type":"object","required":[],"properties":{"action":{"type":"string"},"amount":{"type":"string"},"currency":{"type":"string"},"spent_today":{"type":"string"},"counterparty":{"type":"string","description":"CNPJ, domain or wallet address"},"payment_network":{"type":"string","description":"visa, mastercard, elo, pix, ..."},"payment_ref_sha256":{"type":"string","description":"SHA-256 hex of the payment token reference or PAR (never a card number)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_029JjGz9Csx2wh5moSIY7","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a signed verdict indicating whether a proposed action (type, amount, currency, counterparty) is within an AI agent's mandate and whether its credential is currently active, plus a list of fields not evaluated.","exampleAgentPrompt":"Before I proceed, check whether agent credential abc123 is allowed to make a GET payment action of 500 BRL to counterparty 12.345.678/0001-99 — I need to know if it's within mandate and if the credential is still active.","exampleUseCases":[{"title":"Pre-payment mandate check for autonomous agent","prompt":"I'm about to have my agent send a payment of 1000 BRL to the supplier domain fornecedor.com.br — first check if agent credential cred_xyz is authorized for that action and amount, and confirm its credential hasn't expired."},{"title":"Daily spend limit compliance verification","prompt":"My agent wants to make another payment today totaling 200 USDC — it's already spent 150 USDC today. Check agent cred_abc to see if this action is still within its mandate given the spent_today amount of 150 USDC."},{"title":"Counterparty wallet address authorization check","prompt":"Before my agent interacts with wallet address 0xABCDEF1234567890, verify that credential cred_789 permits actions toward that counterparty and that the credential is currently active."}],"resultDescription":"A signed verdict object confirming whether the action, amount, currency, and counterparty are within the agent's mandate and whether the credential is currently active, along with a list of mandate fields that were not evaluated in this check.","failureModes":["Agent credential ID not found — returns an error indicating the credential does not exist","Credential expired — verdict indicates credential is inactive","Missing required path parameter 'id' — returns validation error","Query parameters malformed (e.g. invalid CNPJ format) — may return partial evaluation with unevaluated fields","Action or currency not recognized — returned in unevaluated fields list","x402 payment not included or invalid — returns 402 Payment Required before processing"],"whenToPreferThis":"Use this endpoint when you need a cryptographically signed, auditable mandate-check before an AI agent executes a financial or operational action in a Brazilian business context. Prefer this over generic auth checks when you need explicit Brazilian CNPJ counterparty validation, per-action and per-amount mandate scoping, and a signed verdict that can be logged for compliance purposes.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T06:45:02.950Z","isFirstParty":false,"canonicalSlug":"kya-brasil-agent-mandate-credential-allowance-check-f6b8e1d2"}