{"uid":"cap_eY8bfGd1jq_pF7L8NCrxk","slug":"x402-doctor-batch-preflight-safety-check-14d4e8a6","name":"x402 Doctor – Batch Preflight Safety Check","description":"Are these x402 endpoints safe to pay? Up to 10 endpoints in one call (?url=a&url=b): per endpoint go / caution / no_go, the recommended payment option and why, plus totals. For marketplaces and agents that weigh several services. Never pays the endpoints.","url":"https://x402-doctor.fizzl.eu/api/v1/preflight/batch?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"},"queryParams":{"type":"object","required":["url"],"properties":{"url":{"type":"array","items":{"type":"string"},"maxItems":10,"description":"The x402 endpoints to check, one url parameter each (?url=a&url=b), at most 10."},"method":{"enum":["GET","POST"],"type":"string","description":"HTTP method you will call them with. Default: try GET, then POST."},"max_usd":{"type":"string","description":"Your budget per call in USD; above it the verdict is no_go."},"network":{"type":"string","description":"CAIP-2 network you want to pay on."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["count","counts","results"],"properties":{"count":{"type":"integer"},"counts":{"type":"object","properties":{"go":{"type":"integer"},"no_go":{"type":"integer"},"caution":{"type":"integer"},"unknown":{"type":"integer"}}},"results":{"type":"array","items":{"type":"object","required":["url","verdict","safe_to_pay","summary"],"properties":{"url":{"type":"string"},"error":{"type":"string"},"options":{"type":"array"},"reasons":{"type":"array"},"summary":{"type":"string"},"verdict":{"enum":["go","caution","no_go","unknown"],"type":"string"},"safe_to_pay":{"type":"boolean"},"recommended_option":{"type":["integer","null"]}}}},"checked_at":{"type":"string"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_0n3YwquCz9Ocaq-qA7nKW","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Checks up to 10 x402 payment endpoints in a single call and returns a go/caution/no_go safety verdict, recommended payment option, and batch totals for each","exampleAgentPrompt":"Before my agent pays any of these services, can you batch-check whether these three x402 endpoints are safe to pay — https://api-a.example.com/data, https://api-b.example.com/search, and https://api-c.example.com/chat — using GET, with a max budget of $0.10 per call, and give me a go/caution/no_go verdict plus the recommended payment option for each?","exampleUseCases":[{"title":"Marketplace vetting pipeline for x402 services","prompt":"I'm building a marketplace listing x402 APIs — before publishing, can you preflight-check these five endpoints to see which are safe to pay, which need caution, and which to reject outright: https://svc1.example.com/api, https://svc2.example.com/query, https://svc3.example.com/generate, https://svc4.example.com/analyze, https://svc5.example.com/fetch?"},{"title":"Agent workflow pre-payment safety screen","prompt":"My AI agent is about to choose between these four x402 data services to call — can you run a batch preflight on https://weather.example.com/now, https://news.example.com/headlines, https://stocks.example.com/price, and https://maps.example.com/route with a max spend of $0.05 each, so I know which ones are actually safe to pay before the agent proceeds?"},{"title":"Budget-aware network-specific vendor selection","prompt":"I want to use base-mainnet for payments and my budget is $0.02 per call — can you check these six x402 endpoints and tell me which ones get a go verdict within that budget: https://a.vendor.com/v1, https://b.vendor.com/v1, https://c.vendor.com/v1, https://d.vendor.com/v1, https://e.vendor.com/v1, https://f.vendor.com/v1?"}],"resultDescription":"Returns a structured batch report containing: total count of checked endpoints; aggregate counts of go, caution, no_go, and unknown verdicts; and per-endpoint objects each with the URL, verdict enum, safe_to_pay boolean, recommended payment option index, array of reasons, and a human-readable summary. Also includes a checked_at ISO timestamp.","failureModes":["URL array exceeds 10 items — request rejected","Unreachable endpoint URLs return unknown verdict with an error field","Invalid CAIP-2 network string may cause network-level filtering to fail","Endpoints that return non-standard x402 headers may get caution or unknown verdicts","Budget string malformed — may default to no budget filtering"],"whenToPreferThis":"Use this endpoint when you need to evaluate multiple x402 payment endpoints simultaneously before committing any funds — ideal for marketplaces, agent orchestrators, or any workflow where several competing x402 services must be ranked or filtered. Prefer this over the single-URL check when you have 2–10 candidates and want batch totals and comparative verdicts in one round-trip. Choose the richer 'full diagnosis' sibling endpoint only when you need deep debugging detail on a single failing endpoint.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T04:06:42.559Z","isFirstParty":false,"canonicalSlug":"x402-doctor-batch-preflight-safety-check-14d4e8a6"}