{"uid":"cap_xlyo8gOR8xuzz2tAEJ81C","slug":"agenttools-http-status-code-lookup-e49456b7","name":"AgentTools HTTP Status Code Lookup","description":"Reference database of HTTP response status codes with phrase, category and explanation. Look up a specific code or list a whole category (1xx–5xx). Use this when an agent needs to look up any HTTP status code's meaning.","url":"https://agenttools-hub.vercel.app/api/v1/dev/http-status-codes?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":[],"properties":{"code":{"type":"number","description":"Leave empty to list by category"},"limit":{"type":"number","description":"Max rows"},"category":{"enum":["","informational","success","redirect","client-error","server-error"],"type":"string","description":"Category"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"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_eDnnxabMVlhrGN0Svk0cG","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":"Look up any HTTP status code's phrase, category, and explanation, or list all codes within a category (1xx–5xx).","exampleAgentPrompt":"What does HTTP status code 429 mean — give me the phrase, category, and a plain-English explanation.","exampleUseCases":[{"title":"Debugging an API error response","prompt":"My API is returning a 502 error — what does that mean, what category is it, and can you explain what's causing it?"},{"title":"Listing all client error codes","prompt":"Show me all HTTP status codes in the client-error category so I can understand which 4xx errors my app might need to handle."},{"title":"Understanding a redirect code","prompt":"What exactly does HTTP status code 301 mean and how is it different from other redirect codes?"}],"resultDescription":"Returns the HTTP status code's official phrase (e.g. 'Not Found'), its category (e.g. 'client-error'), and a human-readable explanation of what the code means. When listing by category, returns an array of all matching codes with their phrases and explanations, up to the specified row limit.","failureModes":["Unknown or invalid status code number returns empty or error response","Invalid category enum value rejected at input validation","Missing required 'type' or 'method' fields causes schema validation error","Non-numeric code parameter may fail type check","Payment failure (x402) if USDC balance insufficient"],"whenToPreferThis":"Use this endpoint when an agent or developer needs an authoritative, structured reference for any HTTP status code — including its official phrase, category bucket (1xx–5xx), and explanation — without relying on a web search or LLM hallucination. Ideal for building error-handling logic, documentation, or when an agent encounters an unfamiliar status code in an API response and needs to understand it programmatically.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T12:40:16.990Z","isFirstParty":false,"canonicalSlug":"agenttools-http-status-code-lookup-e49456b7"}