{"uid":"cap_7xE9h1hfefgGniVzyiRpt","slug":"halowerk-x402werk-offer-validate-fc202555","name":"HALOWERK x402werk — Offer Validate","description":"Validates a 402 challenge — fetched from a URL without paying, or supplied directly — against PaymentRequiredV1Schema and PaymentRequiredV2Schema of the installed @x402/core reference implementation. Reports the detected version and how it was detected, every error with field, expected, found and spec_ref naming package, version, schema and field path, whether the network is valid CAIP-2, whether the asset is a known and canonical token address or a bridged variant, whether the declared inputSch","url":"https://x402.halowerk.com/offer/validate","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"url":{"type":"string","pattern":"^https?://","maxLength":2048,"description":"Absolute http or https URL whose 402 challenge should be fetched and validated. Nothing is paid. Private, loopback and link-local targets are rejected."},"challenge":{"type":"object","description":"A 402 challenge object to validate directly, in x402 v1 or v2 form."},"timeout_ms":{"type":"integer","default":6000,"maximum":12000,"minimum":1000,"description":"Time budget for fetching the foreign challenge."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_83LW-8CX9Fpb4nLJwvgHd","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Validates an x402 payment challenge object (v1 or v2) by fetching and parsing it from a URL or directly from a provided challenge object, returning detailed conformance results.","exampleAgentPrompt":"Check whether this x402 challenge object I built for my API endpoint is valid and spec-compliant — here's the challenge JSON, and let me know if it's compatible with both v1 and v2 clients and whether the price looks sane.","exampleUseCases":[{"title":"Debug a malformed x402 challenge","prompt":"I just deployed an x402-gated endpoint but clients keep rejecting it — can you fetch the challenge from https://api.myapp.com/premium-data and tell me exactly what's wrong with it, including any spec errors or warnings?"},{"title":"Pre-deploy validation of a new offer","prompt":"Before I go live, can you validate this x402 v2 challenge object I drafted for my USDC-on-Base paywall and tell me if the asset is recognized, the price is sane, and whether it'll work with v1 clients?"},{"title":"Check third-party x402 endpoint compatibility","prompt":"I want to integrate with a third-party paid API at https://partner.example.com/data — can you fetch and validate its x402 challenge and tell me what version it is and whether my v1 client will be compatible?"}],"resultDescription":"Returns a structured object indicating overall validity, detected x402 version (v1/v2/unclear), schema validity, CAIP validity, price sanity, whether the asset is known and canonical, compatibility with v1 and v2 clients, a list of specific field-level errors (with field name, problem description, expected vs found values, and spec reference), warnings, extensions, cache status (hit/miss), and the thresholds used during validation.","failureModes":["Private, loopback, or link-local target URLs are rejected outright","Timeout exceeded when fetching a slow remote challenge URL","Malformed input object that doesn't match x402 v1 or v2 schema returns version_detected: unklar","Remote URL returns no 402 challenge or an unexpected HTTP status","Network errors fetching the foreign URL result in an error response"],"whenToPreferThis":"Use this endpoint when you need to programmatically validate the correctness and spec-compliance of an x402 challenge — either by URL or by direct object — especially when debugging paywall integrations, pre-deploying new x402 offers, or checking third-party API compatibility. Prefer this over manual inspection when you need structured error details, CAIP asset validation, version detection, and v1/v2 client compatibility flags in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:34:57.065Z","isFirstParty":false}