{"uid":"cap_wscA5K3DhkA9ypOI1ZV-l","slug":"x402-challenge-shape-check-69b0e45a","name":"X402 Challenge Shape Check","description":"X402 Challenge Shape Check: X402 Challenge Shape Check checks required top-level fields in a caller-supplied payment challenge from bounded caller-supplied values without an external provider. Call X402 Challenge Shape Check before paying for or accepting an x402 or agent delivery assembled from caller-supplied challenge and result metadata. Returns contract-specific checks, normalized evidence, mismatch reasons, and an explicit acceptance or rejection status for X402 Challenge Shape Check as v…","url":"https://api.delx.ai/api/v1/x402/x402-challenge-shape-check","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"challenge":{"type":"object","description":"Challenge supplied to X402 Challenge Shape Check; used only for this bounded calculation and processed in memory without retention.","maxProperties":128,"additionalProperties":true}}},"responseSchema":{"type":"json","example":{"result":{"shape_valid":true,"accept_count":1,"missing_fields":[]},"schema":"delx/util-x402-challenge-shape-check/v1","status":"pass","evidence":{"retained":false,"input_sha256":"62072ab7fce77c19843d604f1566016ce4dbe3ea291d11d208433c905228eeab","external_calls":0},"operation":"delivery_contract:x402_challenge_shape_check"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_HnpVWSXk01YH9hgUTfEcN","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Validates the required top-level fields and structure of a caller-supplied x402 payment challenge object, returning acceptance/rejection status and mismatch reasons.","exampleAgentPrompt":"Before we accept or pay this x402 challenge, can you run a shape check on it to confirm all the required top-level fields are present and the structure is valid — and tell me if anything is missing or mismatched?","exampleUseCases":[{"title":"Pre-payment challenge gate for agent","prompt":"I have an x402 challenge object that just came in from a content paywall — before my agent pays it, can you check its shape and confirm all required fields are there, or flag any mismatches?"},{"title":"Screening incoming agent delivery challenges","prompt":"My agent received a challenge as part of a delivery result. Before we accept it, validate the challenge structure and tell me whether it passes or should be rejected, including any mismatch reasons."},{"title":"Debugging a malformed x402 challenge","prompt":"This x402 challenge keeps getting rejected downstream and I'm not sure why — can you run a shape check on it and show me exactly which required fields are missing or wrong?"}],"resultDescription":"Returns a structured result including: an explicit acceptance or rejection status for the challenge, contract-specific field checks, normalized evidence derived from the challenge, and a list of mismatch reasons explaining any structural problems found.","failureModes":["Challenge object exceeds 128 properties limit, causing rejection","Missing required top-level fields result in explicit rejection status with enumerated mismatch reasons","Malformed JSON in the challenge object may cause a parsing error","Empty challenge object returns rejection with all required fields listed as missing","Network or service errors return HTTP 4xx/5xx without a validation result"],"whenToPreferThis":"Use this endpoint when you need a fast, cheap ($0.001 USDC), stateless structural check on an x402 payment challenge before committing to paying or accepting it. Prefer this over manual field inspection when building agent pipelines that need to gate on challenge validity. It processes in memory without data retention, making it suitable for sensitive challenge objects.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T19:02:51.279Z","isFirstParty":false}