HTTP status code reference (cacheable/retryable) API

Resolve an HTTP status code to its reason phrase, defining RFC, category (1xx-5xx), and the derived operational flags cacheable + retryable — the semantics agents need to decide whether to retry or cache. Answers 'what does 429 mean', 'is 503 retryable', 'RFC for 418', 'is 200 cacheable'.

Price$0.01per request

MethodPOST

Route/v1/ref/http-status

StatusLive

MIME typeapplication/json

Rate limit60/minute

CacheNo cache

refhttp-statusstatus-codehttprfcretryablecacheablerest

API URLhttps://x402.hexl.dev/v1/ref/http-status

Integration docs

Example request

{
  "code": 429
}

Example response

{
  "code": 429,
  "phrase": "Too Many Requests",
  "rfc": "RFC 6585",
  "category": "Client Error",
  "cacheable": false,
  "retryable": true,
  "found": true
}

Input schema

{
  "type": "object",
  "required": [
    "code"
  ],
  "properties": {
    "code": {
      "type": [
        "integer",
        "string"
      ],
      "examples": [
        429,
        200,
        418
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}