HTTP status code lookup API: meaning and whether to retry

$0.01 per call · failed calls are never charged · no account or subscription: pay per call with a card key or USDC

Name and plain-language meaning of an HTTP status code (1xx-5xx, including 402 Payment Required and 429 Too Many Requests), and whether to retry. Use when handling API errors.

When to use it

Run it free (25 free calls) Buy credits by card (from $1) Example result (JSON)

Try it with your own inputs

Status code

Uses one of your 25 free calls. Nothing is charged, and a call that fails is not counted.

Inputs

NameTypeDescription
code (required)integerStatus code

Request

Over HTTP, with a card key from /credits:

curl -H "Authorization: Bearer adt_…" "https://tools.funwords.eu/http/status?code=429"

Or one of your 25 free calls, no key:

curl "https://tools.funwords.eu/http/status?code=429&trial=1"

Without a key, the same URL answers 402 Payment Required with x402 and MPP terms, so an agent with a wallet pays per call in USDC (Base, Polygon, Arbitrum or Solana over x402; Base or Tempo over MPP) and retries.

Example result

{
  "code": 429,
  "name": "Too Many Requests",
  "meaning": "Rate limited; wait (see Retry-After) and retry.",
  "class": "client error",
  "retry": true
}

From an AI agent (MCP)

Add the MCP server to Claude, Cursor or any MCP client. This tool is http_status, and the first 25 successful calls are free:

https://tools.funwords.eu/mcp

Questions

What comes back?

The code's name, a plain-language meaning, its class and whether to retry.

How do I pay?

Each successful call costs $0.01; failed calls are not charged. The first 25 calls are free. Then pay with card credits (from $1; the key goes in an Authorization header or, for clients that can only fetch a URL, as api_key= in the URL) or per call in USDC over x402 or MPP. No account is needed.

Related tools