/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 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_urltool.