{"uid":"cap_qdgV8AbEe_sd77rZvsRZy","slug":"webref-http-status-code-lookup-778b1750","name":"WebRef HTTP Status Code Lookup","description":"Web standards and time reference for AI agents: HTTP status codes with what the client should do, retry semantics, MIME types and content-type matching, request-method safety and idempotency, plus deadline arithmetic - time until a moment, weekday and business-day checks, duration conversion and Unix timestamps. Pay per call in USDC on Base via x402 or USDC on Tempo via MPP. No signup, no API key, no KYC.","url":"https://webref.johnaio281.workers.dev/api/web/http_status?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"},"queryParams":{"code":{"def":{"type":"union","options":[{"def":{"type":"number","checks":[]},"type":"number","isFinite":true},{"def":{"type":"string"},"type":"string"}]},"type":"union","options":[{"def":{"type":"number","checks":[]},"type":"number","isFinite":true},{"def":{"type":"string"},"type":"string"}]},"type":"object","detail":{"def":{"type":"default","innerType":{"def":{"type":"enum","entries":{"full":"full","summary":"summary","decision":"decision"}},"enum":{"full":"full","summary":"summary","decision":"decision"},"type":"enum","options":["summary","full","decision"]},"defaultValue":"full"},"type":"default"}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Vsm1dJfhVtA12D1bOGgvz","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns HTTP status code details for a given code and HTTP method, including client action guidance, retry semantics, and decision summaries.","exampleAgentPrompt":"I just got a 429 status code back from a GET request — what should I do, should I retry, and what does that code actually mean? Give me the full detail.","exampleUseCases":[{"title":"Automated API retry decision logic","prompt":"My agent just received a 503 response to a GET request from an external API — should it retry, back off, or give up? Give me the full breakdown of what a 503 means and the recommended client action."},{"title":"Error handler for DELETE operations","prompt":"What does a 409 Conflict status mean when I send a DELETE request, and what should I do next? I need the full details including retry semantics."},{"title":"Quick status code summary for logging","prompt":"Give me a summary-level explanation of HTTP 404 for a HEAD request — just enough to label it correctly in my error logs."}],"resultDescription":"Returns structured information about the specified HTTP status code in the context of the given HTTP method, including a human-readable meaning, recommended client action, retry semantics, and optionally a concise decision or full detail breakdown depending on the requested detail level.","failureModes":["Missing required 'type' or 'method' fields returns a validation error","Unsupported HTTP method (POST, PUT, PATCH) rejected — only GET, HEAD, DELETE allowed","Invalid or unrecognized status code may return empty or error response","Payment not completed via x402/MPP results in 402 response and no data","Network timeout to Cloudflare Worker edge node"],"whenToPreferThis":"Choose this endpoint when an AI agent needs authoritative, structured guidance on how to handle HTTP status codes at runtime — especially for building retry logic, error classifiers, or client-side decision trees. Ideal when the agent receives an unexpected HTTP response and needs to decide whether to retry, escalate, or abort. Preferred over hardcoded lookup tables because it provides method-aware, decision-oriented output without requiring signup or API keys.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-22T12:40:59.681Z","isFirstParty":false,"canonicalSlug":"webref-http-status-code-lookup-778b1750"}