GET /v1/uptime

Public uptime stats — no auth required, 0 credits. **`uptime_30d_pct` is nullable — type `number | null`, not `number`.** It is `null`, with `checks: 0`, whenever the monitor has written no samples inside the window: the buffer file is absent, or every sample in it predates the 30-day cutoff. Until 2026-08-18 those branches returned `100.0`, which published *no measurement* as *perfect availability*; the honest value is null and it stays null. Guard before any arithmetic or `>=` comparison: ```python pct = r.get("uptime_30d_pct") ok = pct is not None and pct >= 99.9 # not: r["uptime_30d_pct"] >= 99.9 ``` The no-measurement body in full: ```json { "uptime_30d_pct": null, "checks": 0, "status": "no data yet", "probe_target": "https://puntersedge.online/ping", "measures": "puntersedge.online (website), not api.puntersedge.online", "note": "..." } ``` `checks == 0` tests the same condition without touching the nullable field.

Request

curl 'https://api.puntersedge.online/v1/uptime' \
  -H 'X-API-Key: YOUR_KEY'

Parameters

This endpoint takes no parameters beyond authentication.

Responses

Status codes: 200, 401, 402, 429, 500. Response bodies are JSON; the full schema is in /openapi.json.

Example response

200 application/json Field names and types are as the API returns them; values are a real sample, trimmed to a few items.

{
  "uptime_30d_pct": 99.99,
  "checks": 8640,
  "last_status": "ok",
  "monitor_stale": false,
  "window_span_days": 30.0,
  "probe_target": "https://puntersedge.online/ping"
}

Related endpoints

• GET /v1/account — Your account: email, plan, password, billing and consent status
• POST /v1/account/marketing — Turn promotional emails on or off for your account
• POST /v1/account/password — Set or change your account password
• GET /v1/billing/overage — Overage: state, rate and ceiling
• POST /v1/billing/overage — Switch overage on or off
• GET /v1/billing/portal — Self-service billing portal link
• POST /v1/billing/portal — Billing portal link (console; confirms your password)
• GET /v1/billing/upgrade-link — A signed link to your prorated upgrade page