Scans

Run a scan, paid via x402

Runs an agent-readability scan paid via x402 v2 (no account or subscription). Without a valid X-PAYMENT header this returns a v2 402 challenge; sign the EIP-3009 USDC authorization for one of the advertised tiers and resend the v2 payment payload in the X-PAYMENT header to run the scan. Settlement is on Base mainnet (CAIP-2 eip155:8453; the facilitator pays gas); the response carries an X-PAYMENT-RESPONSE header. Tiers: $0.02 (25 pages), $0.25 (250 pages).

post/api/x402/scan

Request

  • Base URL: https://agent-ready.dev
  • URL: https://agent-ready.dev/api/x402/scan
  • Auth: none required

Headers

X-PAYMENTstring

Base64-encoded signed x402 payment authorization. Omit it to receive the 402 challenge.

Request body

urlstring uri required

Response

Payment verified and the scan completed. The X-PAYMENT-RESPONSE header carries the settlement.

shareUrlstring required
claimstring

Signed token letting the payer claim this scan against an account. Present when claim signing is configured.

paymentSettlement'failed'

Present only when the scan succeeded but on-chain settlement did not. The result is still returned rather than failing a paid caller.

Example response

{
  "scan": {
    "id": "V1StGXR8_Z",
    "siteChecks": [
      {
        "checkId": "S1",
        "name": "llms.txt exists"
      }
    ],
    "llmstxtChecks": [
      {
        "checkId": "S1",
        "name": "llms.txt exists"
      }
    ],
    "pageResults": [
      {
        "checks": [
          {
            "checkId": "S1",
            "name": "llms.txt exists"
          }
        ]
      }
    ],
    "protocolResults": [
      {
        "checkId": "S1",
        "name": "llms.txt exists"
      }
    ]
  },
  "shareUrl": "/scan/V1StGXR8_Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.