Checks

Check a URL

GET /api/v1/check-url

Runs a one-shot check of any URL from every monitoring region, no monitor required. Answers “is it down, or is it just me?” with per-region status and timing.

Query Parameters

ParameterTypeDescription
urlstringRequired. The URL to check (must be publicly reachable; private and internal addresses are rejected with a 422)
regions[]arrayRegion codes to check from (defaults to all active regions)
timeout_secondsintegerProbe timeout per region, 1 to 30 (default: 15)

Response

The verdict is up when every region reached the URL, down when every region found it offline, refused when no region reached it and every region that got an answer was turned away with a 403, 406 or 429 (the site is serving, and closed to automated clients), partial when the regions disagree, and unknown when no region could determine either way. Per-region status is online, offline, refused, error (the region itself was unreachable), or blocked (the target's robots.txt disallows probing). reachable_regions counts the online regions and refused_regions the refused ones.

{
  "url": "https://example.com",
  "checked_at": "2026-08-10T14:30:00Z",
  "verdict": "up",
  "reachable_regions": 4,
  "total_regions": 4,
  "results": [
    {
      "region": "ash",
      "name": "Ashburn",
      "status": "online",
      "status_code": 200,
      "response_time_ms": 132,
      "dns_ms": 12,
      "tcp_ms": 24,
      "tls_ms": 41,
      "ttfb_ms": 118
    }
  ]
}

Notes

  • Requires a paid plan (Starter and up): on-demand probes consume multi-region capacity, so they sit outside the free plan's read-only tier.
  • Limited to 20 checks per minute per account, shared with the MCP check_url tool.