Check a URL - API Reference

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

Parameter	Type	Description
`url`	string	Required. The URL to check (must be publicly reachable; private and internal addresses are rejected with a 422)
`regions[]`	array	Region codes to check from (defaults to all active regions)
`timeout_seconds`	integer	Probe timeout per region, 1 to 30 (default: 15)

Response

The verdict is up when every region reached the URL, down when none did, partial when they disagree, and unknown when no region could determine either way. Per-region status is online, offline, error (the region itself was unreachable), or blocked (the target's robots.txt disallows probing).

{
  "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

Available on every plan with API access, including read-only tokens: a check is a read.
Limited to 20 checks per minute per account, shared with the MCP check_url tool.