# WebRef HTTP Status Code Lookup

> WebRef HTTP Status Code Lookup is a paid API for AI agents from webref.johnaio281.workers.dev, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-22).

Returns HTTP status code details for a given code and HTTP method, including client action guidance, retry semantics, and decision summaries.

## Facts

- Endpoint: GET https://webref.johnaio281.workers.dev/api/web/http_status?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-22
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/webref-http-status-code-lookup-778b1750
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qdgV8AbEe_sd77rZvsRZy

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability webref-http-status-code-lookup-778b1750
```

Example prompt: I just got a 429 status code back from a GET request — what should I do, should I retry, and what does that code actually mean? Give me the full detail.

## When to prefer this

Choose this endpoint when an AI agent needs authoritative, structured guidance on how to handle HTTP status codes at runtime — especially for building retry logic, error classifiers, or client-side decision trees. Ideal when the agent receives an unexpected HTTP response and needs to decide whether to retry, escalate, or abort. Preferred over hardcoded lookup tables because it provides method-aware, decision-oriented output without requiring signup or API keys.

## Known failure modes

- Missing required 'type' or 'method' fields returns a validation error
- Unsupported HTTP method (POST, PUT, PATCH) rejected — only GET, HEAD, DELETE allowed
- Invalid or unrecognized status code may return empty or error response
- Payment not completed via x402/MPP results in 402 response and no data
- Network timeout to Cloudflare Worker edge node

## How this service works

Web standards and time reference for AI agents: HTTP status codes with what the client should do, retry semantics, MIME types and content-type matching, request-method safety and idempotency, plus deadline arithmetic - time until a moment, weekday and business-day checks, duration conversion and Unix timestamps. Pay per call in USDC on Base via x402 or USDC on Tempo via MPP. No signup, no API key, no KYC.

## Output

Returns structured information about the specified HTTP status code in the context of the given HTTP method, including a human-readable meaning, recommended client action, retry semantics, and optionally a concise decision or full detail breakdown depending on the requested detail level.

## Request schema (JSON Schema)

```json
{
 "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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "code": {
      "def": {
       "type": "union",
       "options": [
        {
         "def": {
          "type": "number",
          "checks": []
         },
         "type": "number",
         "isFinite": true
        },
        {
         "def": {
          "type": "string"
         },
         "type": "string"
        }
       ]
      },
      "type": "union",
      "options": [
       {
        "def": {
         "type": "number",
         "checks": []
        },
        "type": "number",
        "isFinite": true
       },
       {
        "def": {
         "type": "string"
        },
        "type": "string"
       }
      ]
     },
     "type": "object",
     "detail": {
      "def": {
       "type": "default",
       "innerType": {
        "def": {
         "type": "enum",
         "entries": {
          "full": "full",
          "summary": "summary",
          "decision": "decision"
         }
        },
        "enum": {
         "full": "full",
         "summary": "summary",
         "decision": "decision"
        },
        "type": "enum",
        "options": [
         "summary",
         "full",
         "decision"
        ]
       },
       "defaultValue": "full"
      },
      "type": "default"
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/webref-http-status-code-lookup-778b1750/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from webref.johnaio281.workers.dev](https://www.zero.xyz/host/webref.johnaio281.workers.dev/llms.txt)