Developer API

Everything on this site is available as JSON. No key is needed for personal and low-volume use; please cache results and send a descriptive User-Agent. Limits: 30 checks/min per IP (10 with fresh=1); other endpoints 240/min. Need more? Contact us.

Live check (any domain)

GET https://isitdownorme.com/api/check?domain=github.com
GET https://isitdownorme.com/api/check?domain=github.com&fresh=1   # bypass the 60 s cache

Tests the domain from Dallas, Washington DC, Frankfurt and Singapore in parallel.

{
  "domain": "github.com",
  "verdict": "UP",                 // UP | DEGRADED | DOWN | BLOCKED
  "summary": "github.com is up and reachable from all 4 regions.",
  "p50LatencyMs": 51,
  "checkedAt": "2026-10-26T09:12:31.804Z",
  "cached": false,
  "regions": [
    {
      "region": "vercel-iad1", "ok": true, "httpStatus": 200, "latencyMs": 42, "dnsMs": 3,
      "error": null, "errorDetail": null,
      "finalUrl": "https://github.com/", "redirects": [], "addresses": ["140.82.112.3"],
      "tls": { "issuer": "Sectigo ECC Domain Validation Secure Server CA", "validTo": "2026-11-29T23:59:59.000Z", "daysRemaining": 34 },
      "server": "github.com"
    }
  ]
}

error is one of dns_error, connect_error, tls_error, timeout, no_response (TLS handshake succeeded but no HTTP reply — typical of bot tarpits), http_error, too_many_redirects, blocked_target, invalid_url.

Monitored services

GET https://api.isitdownorme.com/v1/services                  # all services with current verdict
GET https://api.isitdownorme.com/v1/services?category=Social%20Media
GET https://api.isitdownorme.com/v1/services/github           # detail: regions, 24 h history, outages, reports
GET https://api.isitdownorme.com/v1/outages?days=30           # resolved + ongoing outages
GET https://api.isitdownorme.com/v1/outages?open=1            # ongoing only
GET https://api.isitdownorme.com/v1/categories

Service detail includes history — hourly buckets of { t, ok, total, p50 } for the last 24 hours across all regions.

Report a problem

POST https://isitdownorme.com/api/report
Content-Type: application/json

{ "service": "github", "type": "cant_load" }      // or { "domain": "example.org", "type": "slow" }
// type: cant_load | error | login | slow | partial  — one report per target per IP per 10 minutes

Terms