HTTP status code lookup

Look up an HTTP status code or search by words: meaning, typical cause and whether to retry.

Input

A status code such as 404, or words to search for such as "too many requests".

Result

Fill in the input and press Run.

Your input is processed in memory and then discarded. It is not stored or logged. Even so, don't paste live passwords or keys into any online tool.

Use it from code or an agent

curl -s https://setget.net/v1/tools/http-status \
  -H 'Content-Type: application/json' \
  -d '{"input":{"query":"429"}}'
import json, urllib.request

body = {'input': {'query': '429'}}
request = urllib.request.Request("https://setget.net/v1/tools/http-status", json.dumps(body).encode(),
                                 {"Content-Type": "application/json"})
print(json.load(urllib.request.urlopen(request))["result"])
const response = await fetch("https://setget.net/v1/tools/http-status", {
  method: "POST",
  headers: {"Content-Type": "application/json"},
  body: JSON.stringify({"input":{"query":"429"}}),
});
console.log((await response.json()).result);
Tool: run_tool
Arguments:
{
  "slug": "http-status",
  "input": {
    "query": "429"
  }
}
{
  "input": {
    "query": "429"
  }
}

Endpoint: POST /v1/tools/http-status. Over MCP: run_tool with slug: "http-status". Machine-readable: input schema, Markdown. Connect an agent.

Inputs

NameTypeRequiredWhat it does
query string yes A status code such as 404, or words to search for such as "too many requests".

Examples

Input
{
  "query": "429"
}
Result
{
  "query": "429",
  "count": 1,
  "matches": [
    {
      "code": 429,
      "name": "Too Many Requests",
      "class": "client error",
      "official": true,
      "meaning": "The client has sent too many requests in a given time.",
      "cause": "A rate limit was hit; the Retry-After header often says how long to wait.",
      "retry": true
    }
  ]
}

Search by a word

Input
{
  "query": "teapot"
}
Result
{
  "query": "teapot",
  "count": 1,
  "matches": [
    {
      "code": 418,
      "name": "I'm a teapot",
      "class": "client error",
      "official": false,
      "meaning": "A joke code from an April Fools specification; some sites use it to refuse automated requests.",
      "cause": "An Easter egg, or a server that blocks bots with it.",
      "retry": false
    }
  ]
}

Questions

What does "official" mean?
Official codes are in the IANA registry. The others are in real use by nginx, Cloudflare and some frameworks but are not standardised.
What does "retry" tell me?
Whether sending the same request again, after a pause, has a fair chance of working. For most 4xx codes you must change the request first.