HTTP Uptime Check

What It Does

Issues an HTTP HEAD (default) or GET request to the target URL with a configurable timeout and redirect policy. Returns the final status code, total response time, accurate content length (via streamed byte count on GET, or Content-Length header on HEAD), response headers (Content-Type, Server, Cache-Control), the full redirect chain, and — for HTTPS URLs — whether the TLS handshake completed successfully. Non-2xx responses and network failures are reported with status/error fields; only invalid input returns HTTP errors.

Why It's Useful

Know in one call whether a URL is reachable, how fast it responds end-to-end, and whether it is serving the content you expect. Essential for post-deploy smoke tests, CI/CD gating, third-party dependency health checks, and as a building block for custom monitoring dashboards. Distinct from ICMP ping, which only proves a host is reachable at the network layer — an HTTP check proves the actual web service is serving requests.

Use Cases

Parameters

Response Fields

Code Examples

curl "https://api.edgedns.dev/v1/network/http-check" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "url=https://example.com"

const response = await fetch(
  'https://api.edgedns.dev/v1/network/http-check?url=https%3A%2F%2Fexample.com',
  {
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY'
    }
  }
);

const data = await response.json();
console.log(data);

import requests

response = requests.get(
    'https://api.edgedns.dev/v1/network/http-check',
    headers={'Authorization': 'Bearer YOUR_API_KEY'},
    params={
    'url': 'https://example.com'
    }
)

data = response.json()
print(data)

Related Endpoints

External References

Learn more about the standards and protocols behind this endpoint.