Down Checker

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
  }
}

GET

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.

1 credit per call · Typical response time ~140ms

Query parameters

url

string

required

The URL to check. https:// is assumed if the scheme is omitted.

Response

data

object

required

Hide properties

url

string

required

The normalized URL that was tested.

testedFrom

string

required

Always "India (Mumbai)".

httpsStatus

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).

responseTimeMs

integer | null

required

Round-trip time. null only when the hostname never resolved.

ipAddress

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

A target that’s actually down is not an error — you get a 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
  }
}

Getting Started

API Reference

Query parameters

Response

Errors

​Query parameters

​Response

​Errors

Query parameters

Response

Errors