{"uid":"cap_TABnaXEdnnv9FEcxvwabu","slug":"saylor-innovations-http-status-code-reference-fc35cef2","name":"Saylor Innovations HTTP Status Code Reference","description":"HTTP status code reference with name, class, meaning, whether it is retryable or cacheable by default and related codes, or list a whole class","url":"https://saylorinnovations.com/api/dev/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","queryParams"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","POST","PUT","PATCH","DELETE","HEAD"],"type":"string"},"queryParams":{"type":"object","required":["code","class"],"properties":{"code":{"type":"string","description":"HTTP status code such as 404, 429, 503"},"class":{"type":"string","description":"or 1xx-5xx to list a class (omit both for all)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string","const":"json"},"example":{"type":"object","required":["code","name","meaning"],"properties":{"code":{"type":"number","description":"Code assigned by the issuing system"},"name":{"type":"string","description":"Name"},"class":{"type":"string","description":"Class"},"source":{"type":"string","description":"Data source the values come from"},"meaning":{"type":"string","description":"What the status code means and how clients should react"},"related":{"type":"array","description":"Related status codes"},"is_error":{"type":"boolean","description":"True when this is error"},"retryable":{"type":"boolean","description":"True when retrying the request may succeed"},"specification":{"type":"string","description":"RFC section that defines the code"},"cacheable_by_default":{"type":"boolean","description":"Cacheable by default"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_u8w2lHo-7KzTjV1kGL2Hu","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns detailed metadata for a given HTTP status code, including its name, class, meaning, retryability, cacheability, related codes, and specification reference.","exampleAgentPrompt":"What does HTTP status code 429 mean — is it an error, is it retryable, and is there an RFC that defines it?","exampleUseCases":[{"title":"Debugging unexpected API response","prompt":"My API is returning a 422 status code — can you tell me what that means, whether it's an error, and how my client should handle it?"},{"title":"Building retry logic in an HTTP client","prompt":"I'm writing retry logic for my HTTP client — can you check whether a 503 status code is considered retryable and what class it belongs to?"},{"title":"Verifying cacheability of a response code","prompt":"Is a 200 OK response cacheable by default, and what does the spec say about it? I want to know before I configure my CDN."}],"resultDescription":"A JSON object containing the numeric code, human-readable name, class (e.g. 4xx Client Error), plain-English meaning, boolean flags for is_error, retryable, is_redirect, and cacheable_by_default, an array of related status codes, the RFC/specification section that defines it, and the data source.","failureModes":["Missing or invalid 'code' query parameter returns an error response","Unrecognized or non-standard status codes may return no result or partial data","Network or upstream API errors return a non-200 HTTP response","Payment of $0.01 USDC required per call; missing payment returns 402"],"whenToPreferThis":"Use this endpoint when an agent or developer needs authoritative, machine-readable metadata about a specific HTTP status code — including retryability, cacheability, error classification, and spec reference — rather than parsing documentation or relying on heuristics. Ideal for building retry logic, documenting APIs, or explaining unexpected responses to end users.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T12:31:46.897Z","isFirstParty":false,"canonicalSlug":"saylor-innovations-http-status-code-reference-fc35cef2"}