{"uid":"cap_N5YYq5MSn0FK1UendRSTG","slug":"maxwell-x402-block-diagnostics-http-403-block-doctor-9bd676f8","name":"Maxwell x402 – Block Diagnostics (HTTP 403/Block Doctor)","description":"x402 Doctor for a block you hit (e.g. 403): we request the seller ourselves and say whether the block is on your path (IP, region, bot wall) or on the seller side, with what each of us saw. We never buy around a block.","url":"https://api.maxwellinternational.ai/v1/doctor/blocked?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","HEAD","DELETE"],"type":"string"},"headers":{"type":"object","additionalProperties":{"type":"string"}},"queryParams":{"type":"object","additionalProperties":{"type":"string"}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"verdict":"client_problem"}},"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_-2hnGinS_ZJjHUzliM68z","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":"Diagnoses why an HTTP request to a seller endpoint was blocked (e.g. 403), determining whether the block is on the client's path (IP, region, bot wall) or the seller's side, by independently requesting the seller and comparing results.","exampleAgentPrompt":"I keep getting a 403 when my agent tries to hit this seller endpoint via GET — can you run a block diagnosis and tell me whether the problem is on my path (IP or region block, bot wall) or on the seller's side, and what each side actually saw?","exampleUseCases":[{"title":"Debugging agent IP block vs seller firewall","prompt":"My automated agent is getting 403 errors when it tries to GET from a seller endpoint. Can you diagnose whether the block is because of my agent's IP address or region, or whether the seller is blocking all traffic on their end?"},{"title":"Bot wall detection for agentic workflow","prompt":"I'm not sure if a bot detection wall is blocking my GET requests to this vendor, or if the seller themselves set up the restriction. Run a block doctor check and tell me what each side saw."},{"title":"Regional restriction investigation","prompt":"My requests to a seller API keep returning 403 — I want to know if it's a regional block on my side or a seller-side issue. Can you probe it with a HEAD request and give me a verdict on whose side the problem is?"}],"resultDescription":"Returns a JSON verdict indicating whether the block is a client-side problem (IP, region, or bot wall on the requester's path) or a seller-side problem, along with what each party observed during the independent probe. Does not attempt to circumvent or buy around the block.","failureModes":["Seller endpoint is unreachable entirely, making comparison impossible","Block is intermittent or rate-limit-based, leading to inconsistent results","Input method not among allowed values (GET, HEAD, DELETE), returning validation error","Seller endpoint requires authentication headers not provided, skewing diagnosis","Ambiguous verdict if both sides see similar responses"],"whenToPreferThis":"Use this endpoint when an agent or client is experiencing HTTP 403 or other block responses from a seller endpoint and needs to determine whether the issue is on the requester's side (IP, region, bot detection) versus the seller's configuration — without attempting to bypass or circumvent the block. Prefer this over generic HTTP testing tools when you need a structured, interpretable verdict with dual-perspective comparison.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T18:46:54.591Z","isFirstParty":false,"canonicalSlug":"maxwell-x402-block-diagnostics-http-403-block-doctor-9bd676f8"}