Evaluate agent payment policy from query parameters

Changed on

GET variant of the payment preflight endpoint.

get/api/agent/can-pay

Request

  • Base URL: https://ontarioprotocol.com
  • URL: https://ontarioprotocol.com/api/agent/can-pay
  • Auth: none required

Query parameters

endpointstring required

Paid API endpoint URL the agent wants to evaluate before payment.

max_usdcstring

Maximum USDC-denominated amount the agent policy allows for this call.

agent_policy'strict' | 'standard' | 'permissive'

Named agent payment policy profile to apply to the decision.

verify_liveboolean

Whether Ontario should perform a fresh live verification before deciding.

require_audit_receiptboolean

true requests a settlement-backed receipt handoff in addition to the free policy decision.

Response

Payment decision

agent_policystring
auditable_paid_continuationobject

Optional 0.002 USDC receipt path. It is recommended only after an allow decision and an explicit require_audit_receipt request.

decision'allow' | 'review' | 'deny'
declared_price_usdcnumber nullable
endpointstring
max_usdcnumber nullable
reasonstring
reasonsstring[]
recommendationsobject[]
report_integrity_okboolean
warningsstring[]

Changes

  • 54384a1c4bf3Revision changes
    • info

      added the new optional query request parameter require_audit_receipt

    • info

      added the optional property to the response with the status