---
title: "Evaluate whether an agent should pay an endpoint"
method: POST
path: "/api/agent/can-pay"
---

# Evaluate whether an agent should pay an endpoint

`POST /api/agent/can-pay`

Free pre-payment policy decision for AI agents deciding whether to pay an x402 endpoint.

## Request body

- object
  - `agent_policy` 'strict' | 'standard' | 'permissive'
  - `endpoint` string, required — Paid API endpoint URL the agent wants Ontario to inspect before payment.
  - `max_usdc` string
  - `require_audit_receipt` boolean — Set true only when the caller explicitly needs the optional 0.002 USDC settlement-backed evidence receipt after an allow decision.
  - `verify_live` boolean

## Response `200`

Payment decision

- AgentCanPayDecision
  - `agent_policy` string
  - `auditable_paid_continuation` object — 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_usdc` number, nullable
  - `endpoint` string
  - `max_usdc` number, nullable
  - `reason` string
  - `reasons` string[]
  - `recommendations` object[]
  - `report` VerificationSummary
    - `grade` string
    - `normalized_base` string
    - `readiness_score` integer
    - `report_id` string
    - `report_url` string
    - `target_url` string
    - `verified_at` string
  - `report_integrity_ok` boolean
  - `warnings` string[]

## Other responses

- `400` — Missing endpoint

---

[API](https://skmtc.net/ontarioprotocol/apis/ontario-protocol-x402-api.md) · [All operations](https://skmtc.net/ontarioprotocol/apis/ontario-protocol-x402-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ontarioprotocol/ontario-protocol-x402-api/revisions/54384a1c4bf3/schema)