x402AgentTools

๐Ÿ“ถHTTP Status Codes Database

Reference database of HTTP response status codes with phrase, category and explanation. Look up a specific code or list a whole category (1xxโ€“5xx).

Worked examples

What is HTTP 402?

GET /api/v1/dev/http-status-codes?code=402

Result: 402 Payment Required

All client errors

GET /api/v1/dev/http-status-codes?category=client-error&limit=20

Result: 15 status codes โ€” 4xx Client Error

What is 301?

GET /api/v1/dev/http-status-codes?code=301

Result: 301 Moved Permanently

Machine API (x402)

$0.001 / call

This tool is also a JSON API for AI agents. Requests without payment receive 402 Payment Required plus instructions; agents pay USDC on Base via the x402 protocol โ€” no accounts, no API keys.

GET /api/v1/dev/http-status-codes?code=402 HTTP/1.1
Host: agenttools-hub.vercel.app

โ†’ 402 (payment required, instructions in headers)
โ†’ 200 (after X-PAYMENT header; JSON body below)

{
  "tool": "dev/http-status-codes",
  "input": {"code":402},
  "result": { "value": 402, "answer": "402 Payment Required" }
}

Agent docs: /llms.txt ยท OpenAPI spec ยท integration guide

About this tool

Every HTTP response starts with a three-digit status code: 1xx informational, 2xx success, 3xx redirect, 4xx client error, 5xx server error. Look up any code โ€” including 402 Payment Required, the code the x402 protocol revived for machine-to-machine payments.

Frequently asked questions

What is the difference between 401 and 403?

401 means 'who are you?' โ€” authenticate first. 403 means 'I know who you are and you still can't do this'.

Is 402 Payment Required actually used?

Historically reserved, now actively used by the x402 protocol: APIs return 402 with payment requirements and AI agents pay USDC before retrying.

Related tools