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
Response
Hide properties
Hide properties
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).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?