Health API

Return a public snapshot of AnyRouter's runtime health: overall status, when it was checked, and a components breakdown. No API key required. Wire it into status pages or probes.

Request

No parameters and no auth header. Recommended polling interval: ≥ 60 s (see Caching).

GET /api/v1/health HTTP/1.1

Prefer the dedicated API host if a client (including default curl) receives HTML instead of JSON:

curl https://api.anyrouter.dev/api/v1/health

https://anyrouter.dev/api/v1/health is the same Worker.

Response

The handler always returns HTTP 200 on success. Read status in the JSON body — do not treat the HTTP code as the health signal.

Each component has its own status. They are independent:

• components.api is last-hour generation error rate (can be down during a traffic spike). BYOK requests (generations.is_byok = 1) are excluded entirely — a user's own upstream key is not a platform signal. A failed request only counts as an error when its final attempt was a real platform outage (404/410, any 5xx, or failure_class health/capability) — a key-permission failure (401/403, credential) never counts.
• components.providers lists routing backend ids that served traffic in the last hour (cloudflare, not openrouter-byok) — not catalog model owners (openai, z-ai), and not -byok/-pool backends (a user's or donor's own key is their problem, never a platform incident). Idle backends are omitted. Last-hour generations whose provider_id is not a public backend appear as unattributed so this list and components.api.data.requests_1h share one window. Quarantine, budget-exhausted, and smoke-exclusion overlay the traffic-derived status so a skipped backend cannot read healthy. Error counting follows the same real-outage-only rule as components.api.
• components.routing.summary.healthy is how many upstreams are currently routable — it subtracts quarantined and budget-exhausted backends, so it will not read N/N while those suppressions are active.
• components.smoke_tests.last_run is the daily catalog smoke (00
  UTC). A run from earlier today is expected; data.stale is true only when last_run is older than two days (2× the daily cadence).
• events is a chronological list of upstream status-change events (not every probe tick), newest first, capped at 50. -byok/-pool upstreams never appear here.
• components.postgres and components.clickhouse are optional archives. They report probe status from the homelab latency check. They never move overall status — inference, API keys, and billing stay on D1, Analytics Engine, and R2.

{
  "status": "healthy",
  "description": "All systems operational.",
  "version": "1.4.0",
  "checked_at": "2026-08-18T12:00:00.000Z",
  "components": {
    "api": {
      "status": "healthy",
      "description": "Processing requests normally. 12847 requests in the last hour with 2.1% error rate.",
      "note": "Derived from the last 1 hour of traffic.",
      "data": {
        "requests_1h": 12847,
        "error_rate": 0.021,
        "latency_ms": { "avg": 340 },
        "cache_hit_rate": 0.35
      }
    },
    "providers": {
      "status": "healthy",
      "description": "All 1 providers that served traffic are operational.",
      "note": "Each row is a routing backend id (`generations.provider_id`), not a catalog model owner. Status is the last-hour error rate, overlaid with quarantine / budget-exhausted / smoke-exclusion.",
      "data": {
        "providers": [
          {
            "name": "cloudflare",
            "status": "healthy",
            "description": "Operating normally (5421 requests, 1.2% errors).",
            "latency_ms": 120,
            "requests_1h": 5421,
            "error_rate": 0.012
          }
        ]
      }
    },
    "smoke_tests": {
      "status": "healthy",
      "description": "All 80 tested models passed.",
      "note": "The daily smoke-test workflow (00:00 UTC) sends a real one-token request through chat/completions, responses, and messages.",
      "data": {
        "total": 80,
        "passed": 80,
        "failed": 0,
        "skipped": 0,
        "last_run": "2026-08-18T00:00:00.000Z",
        "stale": false,
        "cadence": "0 0 * * *"
      }
    },
    "workflows": {
      "status": "healthy",
      "description": "All 8 scheduled workflows are running on cadence.",
      "note": "Each scheduled workflow that has recorded a run is checked against its last run. Jobs that have never run are omitted.",
      "data": {
        "healthy": 8,
        "stale": 0,
        "failing": 0,
        "never_ran": 0,
        "workflows": [
          {
            "kind": "gateway-log-sync",
            "label": "Gateway log sync",
            "state": "healthy",
            "last_status": "success",
            "last_run_at": "2026-08-18T11:45:00.000Z",
            "age_hours": 0.1,
            "detail": "Last run success 0.1h ago."
          }
        ]
      }
    },
    "routing": {
      "status": "healthy",
      "description": "All 84 routing upstreams are healthy.",
      "note": "Live routing health from the smoke-cooldown store, plus active quarantine and monthly-budget suppression.",
      "data": {
        "summary": {
          "total": 84,
          "healthy": 84,
          "deprioritized": 0,
          "excluded": 0,
          "quarantined": 0,
          "budget_exhausted": 0
        },
        "degraded": []
      }
    }
  },
  "events": [
    {
      "at": "2026-08-18T11:10:00.000Z",
      "upstream_id": "cerebras",
      "from": "healthy",
      "to": "degraded",
      "message": "HTTP 503: Service Unavailable"
    }
  ]
}

Every component object has status (same enum), description, note (how the check is derived), and data.

A binary probe can treat any top-level status other than healthy as not fully operational. Pair provider rows with /api/v1/providers for logos and descriptions.

Responses also include X-RateLimit-Limit, X-RateLimit-Window, and X-RateLimit-Tier (anonymous callers use the IP tier). A 429 honors Retry-After. See Rate Limits.

Examples

curl https://api.anyrouter.dev/api/v1/health

import httpx

health = httpx.get("https://api.anyrouter.dev/api/v1/health").json()
if health["status"] != "healthy":
    print(health["description"], health["components"]["providers"]["status"])

const res = await fetch("https://api.anyrouter.dev/api/v1/health")
const health = await res.json()
if (health.status !== "healthy") {
  console.warn(health.description, health.components)
}

Status codes

This endpoint does not use HTTP 503 for a down component — read status and components.*.status.

Caching

Anonymous responses are cacheable. The Worker stamps:

Cache-Control: public, max-age=60, s-maxage=300, stale-while-revalidate=600

Browsers may reuse the body for 60 seconds; the shared edge may keep it for 5 minutes and serve a stale copy for up to 10 minutes while one request refreshes it. Poll at ≥ 60 s.

Related

• Providers — catalog of upstream backends
• Models — the catalog
• Rate Limits — X-RateLimit-* headers
• API Overview — every endpoint at a glance