Domain health API

One request, one verdict: DNS propagation, SSL certificate, and registration expiry for any domain, as JSON. Free, keyed with just an email — no account, no card.

Get a free key

Enter your email and we'll generate a key. It's shown once — copy it now.

We log the domains you check and your email to run and improve the service — nothing else. A queried domain can be sensitive, so we keep this minimal.

Endpoint

GET https://ismydomainok.com/v1/check?domain=<domain>

Authentication

Send your key as a bearer token:

Authorization: Bearer imdok_YOUR_KEY

A missing or unknown key returns 401.

Example

curl -H "Authorization: Bearer imdok_YOUR_KEY" \
  "https://ismydomainok.com/v1/check?domain=example.com"

Response

The same payload the web check returns — verdict first, with the raw DNS, SSL, and registration detail:

{
  "domain": "example.com",
  "checkedAt": "2026-06-16T09:00:00.000Z",
  "verdict": { "status": "healthy", "headline": "..." },
  "dns":  { "status": "healthy", "agreeingResolvers": 3, "totalResolvers": 3, "records": ["..."] },
  "ssl":  { "status": "healthy", "available": true, "state": "valid",
            "handshakeOk": true, "issuer": "...", "expiryDate": "...", "daysLeft": 240 },
  "domainReg": { "status": "healthy", "registrar": "...", "expiryDate": "...", "daysLeft": 310 }
}

Limits

100 requests/day per key (resets at 00:00 UTC). Over quota → 429 with {"error":"quota_exceeded"}.
20 requests/minute per key, to keep things smooth. Over → 429 rate_limited.
Successful responses include X-RateLimit-Remaining and X-RateLimit-Reset headers.

It's a free demand-validation experiment — generous enough to build against, no billing or signups. If you need more, email us (the address you used for your key).