curl "https://api.pocketutils.com/v1/down-check?url=https://example.com" \
-H "Authorization: Bearer YOUR_API_KEY"
const res = await fetch(
"https://api.pocketutils.com/v1/down-check?url=https://example.com",
{ headers: { Authorization: "Bearer YOUR_API_KEY" } },
);
const { data } = await res.json();
import requests
res = requests.get(
"https://api.pocketutils.com/v1/down-check",
params={"url": "https://example.com"},
headers={"Authorization": "Bearer YOUR_API_KEY"},
)
data = res.json()["data"]
{
"success": true,
"data": {
"url": "https://example.com",
"testedFrom": "India (Mumbai)",
"httpsStatus": 200,
"responseTimeMs": 214,
"ipAddress": "93.184.216.34"
}
}
{
"success": true,
"data": {
"url": "https://this-domain-does-not-resolve.example",
"testedFrom": "India (Mumbai)",
"httpsStatus": null,
"responseTimeMs": null,
"ipAddress": null
}
}
Site Scanning
Down Checker
Check whether a site is reachable, with HTTP status, latency, and resolved IP.
GET
/
v1
/
down-check
curl "https://api.pocketutils.com/v1/down-check?url=https://example.com" \
-H "Authorization: Bearer YOUR_API_KEY"
const res = await fetch(
"https://api.pocketutils.com/v1/down-check?url=https://example.com",
{ headers: { Authorization: "Bearer YOUR_API_KEY" } },
);
const { data } = await res.json();
import requests
res = requests.get(
"https://api.pocketutils.com/v1/down-check",
params={"url": "https://example.com"},
headers={"Authorization": "Bearer YOUR_API_KEY"},
)
data = res.json()["data"]
{
"success": true,
"data": {
"url": "https://example.com",
"testedFrom": "India (Mumbai)",
"httpsStatus": 200,
"responseTimeMs": 214,
"ipAddress": "93.184.216.34"
}
}
{
"success": true,
"data": {
"url": "https://this-domain-does-not-resolve.example",
"testedFrom": "India (Mumbai)",
"httpsStatus": null,
"responseTimeMs": null,
"ipAddress": null
}
}
Makes a single HTTP(S) request to the URL (following up to 5 redirects) and reports whether it responded, with what status, how long it took, and which IP it resolved to. The request is made from PocketUtils’ servers in India, so results reflect reachability from that vantage point.
A target that’s actually down is not an error — you get a
1 credit per call
Query parameters
string
required
The URL to check.
https:// is assumed if the scheme is omitted.Response
object
required
Hide properties
Hide properties
string
required
The normalized URL that was tested.
string
required
Always
"India (Mumbai)".integer | null
required
The HTTP status code returned, including 4xx/5xx — any status counts as “reachable.”
null only when the request couldn’t complete at all (DNS failure, connection refused, timeout).integer | null
required
Round-trip time.
null only when the hostname never resolved.string | null
required
Resolved IPv4 address (falls back to whatever DNS returns if no A record exists).
null if DNS resolution failed.A
null httpsStatus with a non-null ipAddress means DNS resolved but the connection itself failed or timed out (15s timeout) — that’s a genuinely down host, not a bad request. A null ipAddress means the domain doesn’t resolve at all.Errors
| Status | Cause |
|---|---|
400 | url query parameter missing |
200 with httpsStatus: null. See the full error reference for the platform-level codes (401, 402, 429) that apply to every endpoint.
curl "https://api.pocketutils.com/v1/down-check?url=https://example.com" \
-H "Authorization: Bearer YOUR_API_KEY"
const res = await fetch(
"https://api.pocketutils.com/v1/down-check?url=https://example.com",
{ headers: { Authorization: "Bearer YOUR_API_KEY" } },
);
const { data } = await res.json();
import requests
res = requests.get(
"https://api.pocketutils.com/v1/down-check",
params={"url": "https://example.com"},
headers={"Authorization": "Bearer YOUR_API_KEY"},
)
data = res.json()["data"]
{
"success": true,
"data": {
"url": "https://example.com",
"testedFrom": "India (Mumbai)",
"httpsStatus": 200,
"responseTimeMs": 214,
"ipAddress": "93.184.216.34"
}
}
{
"success": true,
"data": {
"url": "https://this-domain-does-not-resolve.example",
"testedFrom": "India (Mumbai)",
"httpsStatus": null,
"responseTimeMs": null,
"ipAddress": null
}
}
Was this page helpful?