Home / API docs / Uptime Check API
Monitoring

Uptime Check API

GET /api/uptime $0.002 per call USDC on Base · x402

Uptime/health probe for any public URL: sends a HEAD request (auto GET fallback when the server refuses HEAD), follows redirects with per-hop safety checks, and returns up/down, HTTP status, latency in ms, redirect chain, final URL, and key response headers. Deterministic, no page download — a monitoring probe agents can call on a schedule.

Parameters

NameInDescription
urlqueryrequiredPublic http(s) URL to check, e.g. https://example.com

Example request

curl "https://api.webbersites.com/api/uptime?url=https%3A%2F%2Fexample.com"
# first call returns 402 + payment requirements; an x402 client pays and retries automatically

Example response

{
    "url": "https://example.com",
    "up": true,
    "status": 200,
    "latency_ms": 132,
    "method": "HEAD",
    "final_url": "https://example.com/",
    "redirects": 0,
    "headers": {
        "server": "ECS",
        "content_type": "text/html"
    },
    "checked_at": "2026-07-08T00:00:00.000Z"
}
MCP tool: get_uptime — via npx -y webbersites-x402-mcp (local, key stays on your machine) or the remote endpoint https://api.webbersites.com/mcp.

How payment works

There is no signup and no API key. Call the endpoint; it replies 402 Payment Required with machine-readable payment requirements. Your client signs a USDC transfer authorization (EIP-3009, gasless) and retries with the X-PAYMENT header — @x402/fetch does this automatically. See the overview for a working snippet.