{"uid":"cap_H2SH9fukAkDOfR5jZH9ah","slug":"dev-reference-http-status-codes-by-class-065b552c","name":"Dev Reference – HTTP Status Codes by Class","description":"All registered HTTP status codes in a class (1xx to 5xx) with names and one-line meanings.","url":"https://dev-reference.x402tookit.com/http-status-class?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"],"type":"string"},"queryParams":{"type":"object","required":["class"],"properties":{"class":{"type":"integer","description":"First digit of the code: 1, 2, 3, 4 or 5"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"asOf":{"type":["null","string"]},"class":{"type":["null","string"]},"codes":{"type":["array","null"],"items":{"type":"object","properties":{"code":{"type":["null","number"]},"name":{"type":["null","string"]},"meaning":{"type":["null","string"]}}}},"count":{"type":["null","number"]},"source":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"classDigit":{"type":["null","number"]},"disclaimer":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"description":{"type":["null","string"]},"registryRetrieved":{"type":["null","string"]}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_c9FmFWOXo9TGqmdUbZafl","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns all registered HTTP status codes in a given class (1xx–5xx) with their names and one-line meanings.","exampleAgentPrompt":"Give me a full list of all HTTP 4xx status codes with their names and what each one means — I want to see every code registered in the client-error class.","exampleUseCases":[{"title":"Building an HTTP error reference chart","prompt":"Show me every HTTP 5xx status code with its name and a one-line explanation — I'm building a quick reference guide for server errors."},{"title":"Reviewing all redirect response codes","prompt":"Can you list all the HTTP 3xx redirect codes, including their official names and what each one is for?"},{"title":"Documenting API success responses","prompt":"I need a complete list of all HTTP 2xx status codes with their meanings so I can document which success responses my API might return."}],"resultDescription":"A structured response containing the class label, a description of the class, the total count of codes, a list of objects each with a numeric status code, its official IANA name, and a one-line meaning, plus metadata like source and the date the registry was retrieved.","failureModes":["Missing or invalid `class` query parameter (not 1–5) — likely returns an error or empty result","Non-integer value passed as class digit — schema validation failure","Network or upstream registry unavailability — degraded flag may be set in response","Class digit outside valid range (e.g. 6 or 0) — no matching codes returned"],"whenToPreferThis":"Choose this endpoint when you need a comprehensive enumeration of all HTTP status codes within a specific class (1xx–5xx), rather than looking up a single known status code. Prefer it over a single-code lookup endpoint when you want to build reference tables, populate dropdowns, validate ranges, or present a complete class overview to a user or documentation system.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-26T22:29:06.499Z","isFirstParty":false,"canonicalSlug":"dev-reference-http-status-codes-by-class-065b552c"}