Who it is for
Use focused checks for a single decision or assemble a broader profile when context matters.
Try a product, outcome, endpoint path, or API topic.
Comprehensive health check for a domain including DNS, SSL, website reachability, and security headers.
Comprehensive health check for a domain including DNS, SSL, website reachability, and security headers.
Use focused checks for a single decision or assemble a broader profile when context matters.
Choose this for a concise health view across important domain, DNS, and security signals.
Comprehensive health check for a domain including DNS, SSL, website reachability, and security headers.
See what each endpoint accepts and returns, its modes and its limits before you integrate.
1-3 Authentication required. See the API reference for the exact cost, including any per-item pricing.
Use documented operations to collect, assess, enrich, verify, compare, protect, or monitor public evidence.
| Parameter | Type | required |
|---|---|---|
| domain | string | required |
| details |
boolean
Default
true
|
optional |
| Field | Type |
|---|---|
domain |
string |
health_score |
integer |
grade |
string |
checks |
object |
checks.dns_configured |
boolean |
checks.ssl_valid |
boolean |
checks.email_deliverable |
boolean |
checks.blacklist_status |
string |
checks.age_years |
integer | null |
checks.registration_stable |
boolean |
checks.dnssec_enabled |
boolean |
enriched |
object |
enriched.tls |
object |
enriched.tls.grade |
string |
enriched.tls.protocol |
string | null |
enriched.tls.cipher |
string | null |
enriched.tls.chain_valid |
boolean |
enriched.tls.days_to_expiry |
integer |
enriched.tls.hostname_match |
boolean | null |
enriched.tls.ocsp_stapling |
boolean |
enriched.tls.grade_reasons[] |
string[] |
enriched.http_versions |
object |
enriched.http_versions.http1_1 |
boolean |
enriched.http_versions.http2 |
boolean |
enriched.http_versions.http3 |
boolean |
enriched.http_versions.alt_svc |
string | null |
enriched.http_versions.http3_advertised |
boolean |
enriched.http_versions.alt_svc_protocols[] |
string[] |
enriched.http_versions.curl_http3_supported |
boolean |
enriched.http_versions.h2_alpn_accepted |
string | null |
enriched.http_versions.h3_alpn_accepted |
string | null |
enriched.hsts |
object |
enriched.hsts.reachable |
boolean |
enriched.hsts.final_url |
string | null |
enriched.hsts.status_code |
integer | null |
enriched.hsts.header_present |
boolean |
enriched.hsts.hsts_header |
string | null |
enriched.hsts.max_age |
integer | null |
enriched.hsts.include_subdomains |
boolean | null |
enriched.hsts.preload_directive |
boolean | null |
enriched.hsts.preload_eligible |
boolean |
enriched.hsts.preload_status |
string | null |
enriched.hsts.preloaded_domain |
string | null |
enriched.hsts.preload_bulk |
boolean | null |
enriched.hsts.issues[] |
string[] |
enriched.hsts.errors[] |
string[] |
enriched.smtp |
object |
enriched.smtp.host |
string |
enriched.smtp.port |
integer |
enriched.smtp.reachable |
boolean |
enriched.smtp.tls_mode |
string |
enriched.smtp.tls_negotiated |
boolean |
enriched.smtp.tls_protocol |
string |
enriched.smtp.tls_cipher |
string |
enriched.smtp.starttls_offered |
boolean | null |
enriched.smtp.banner |
string |
enriched.smtp.error |
string |
enriched.smtp.fcrdns |
object |
enriched.smtp.fcrdns.addresses[] |
string[] |
enriched.smtp.fcrdns.ptr_hostnames[] |
string[] |
enriched.smtp.fcrdns.all_forward_confirmed |
boolean |
enriched.smtp.fcrdns.confirmed_addresses[] |
string[] |
enriched.smtp.fcrdns.unconfirmed_addresses[] |
string[] |
warnings[] |
string[] |
recommendations[] |
string[] |
component_summary |
object |
component_summary.score |
integer |
component_summary.grade |
string |
component_summary.check_count |
integer |
component_summary.passed_count |
integer |
component_summary.failed_count |
integer |
component_summary.warning_count |
integer |
component_summary.recommendation_count |
integer |
component_summary.confidence |
string |
component_summary.dns_ok |
boolean |
component_summary.https_ok |
boolean |
component_summary.email_ok |
boolean |
component_summary.blacklist_status |
string |
component_summary.dnssec_enabled |
boolean |
component_summary.enriched_section_count |
integer |
component_summary.enriched_sections[] |
string[] |
details |
object |
health_checks[] |
object[] |
health_checks[] |
object |
health_checks[].category |
string |
health_checks[].name |
string |
health_checks[].passed |
boolean |
health_checks[].score |
integer |
health_checks[].weight |
integer |
health_checks[].details |
string | null |
checked_at |
string |
meta |
object |
meta.check_duration_ms |
integer |
meta.served_by |
string |
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/health?domain=example.com&details=true"const response = await fetch("https://domscan.net/v1/health?domain=example.com&details=true", {
headers: { "X-API-Key": process.env.DOMSCAN_API_KEY },
});
const data = await response.json();
console.log(data);import os
import requests
response = requests.get(
"https://domscan.net/v1/health?domain=example.com&details=true",
headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
)
print(response.json())package main
import (
"fmt"
"io"
"net/http"
"os"
)
func main() {
req, err := http.NewRequest(http.MethodGet, "https://domscan.net/v1/health?domain=example.com&details=true", nil)
if err != nil {
panic(err)
}
req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))
resp, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
data, err := io.ReadAll(resp.Body)
if err != nil {
panic(err)
}
fmt.Println(resp.Status, string(data))
}require "json"
require "net/http"
uri = URI("https://domscan.net/v1/health?domain=example.com&details=true")
request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
http.request(request)
end
puts JSON.pretty_generate(JSON.parse(response.body)){
"domain": "cloudflare.com",
"health_score": 94,
"grade": "A",
"checks": {
"dns_configured": true,
"ssl_valid": true,
"email_deliverable": true,
"blacklist_status": "clean",
"age_years": 15,
"registration_stable": true,
"dnssec_enabled": true
},
"enriched": {
"tls": {
"grade": "A+",
"protocol": "TLSv1.3",
"cipher": "TLS_AES_256_GCM_SHA384",
"chain_valid": true,
"days_to_expiry": 72,
"hostname_match": true,
"ocsp_stapling": true,
"grade_reasons": [
"TLS 1.3 enabled",
"Valid certificate chain"
]
},
"http_versions": {
"http1_1": true,
"http2": true,
"http3": true,
"alt_svc": "h3=\":443\"; ma=86400",
"http3_advertised": true,
"alt_svc_protocols": [
"h3"
],
"curl_http3_supported": true,
"h2_alpn_accepted": "h2",
"h3_alpn_accepted": "h3"
},
"hsts": {
"reachable": true,
"final_url": "https://cloudflare.com/",
"status_code": 200,
"header_present": true,
"hsts_header": "max-age=31536000; includeSubDomains",
"max_age": 31536000,
"include_subdomains": true,
"preload_directive": false,
"preload_eligible": true,
"preload_status": "preloaded",
"preloaded_domain": "cloudflare.com",
"preload_bulk": false,
"issues": [
"missing preload directive"
],
"errors": []
}
},
"warnings": [],
"recommendations": [
"Publish the HSTS preload directive if you want preload-list eligibility."
],
"checked_at": "2026-04-18T21:00:00Z",
"details": {
"dns": {
"has_a_record": true,
"has_aaaa_record": true,
"has_nameservers": true,
"has_mx_record": true,
"nameservers": [
"ns3.cloudflare.com",
"ns5.cloudflare.com"
],
"mx_records": [
"route1.mx.cloudflare.net"
],
"a_records": [
"104.16.132.229",
"104.16.133.229"
],
"aaaa_records": [
"2606:4700::6810:84e5",
"2606:4700::6810:85e5"
]
},
"ssl": {
"https_works": true,
"certificate_valid": true,
"days_until_expiry": 72,
"issuer": "Google Trust Services"
},
"email": {
"has_mx": true,
"has_spf": true,
"has_dmarc": true,
"has_dkim_selector": true,
"spf_record": "v=spf1 include:_spf.google.com ~all",
"dmarc_policy": "reject",
"mx_hosts": [
"route1.mx.cloudflare.net"
]
},
"security": {
"dnssec_enabled": true,
"has_caa_record": true,
"caa_issuers": [
"digicert.com",
"letsencrypt.org"
],
"http_to_https_redirect": true,
"has_security_txt": true,
"security_txt_fields": [
"Contact",
"Expires",
"Preferred-Languages"
],
"security_headers": {
"has_hsts": true,
"hsts_max_age": 31536000,
"has_csp": true,
"has_x_frame_options": true,
"has_x_content_type_options": true,
"has_referrer_policy": true,
"has_permissions_policy": true,
"score": 92
}
},
"age": {
"registration_date": "2010-07-06T00:00:00Z",
"expiration_date": "2030-07-06T00:00:00Z",
"last_updated": "2025-07-06T00:00:00Z",
"age_days": 5766,
"age_years": 15,
"days_until_expiry": 1540,
"registrar": "Cloudflare Registrar"
},
"blacklist": {
"clean": true,
"status": "clean",
"listed_on": [],
"checked_lists": [
"spamhaus",
"surbl"
],
"domain_listed_on": [],
"ip_listed_on": [],
"check_type": "mixed"
}
},
"health_checks": [
{
"category": "dns",
"name": "Authoritative DNS records present",
"passed": true,
"score": 100,
"weight": 15
}
],
"meta": {
"check_duration_ms": 248,
"served_by": "pop=MAD country=ES"
}
}
200 OK401 Unauthorized402 Payment Required429 Too Many RequestsUse the API reference for Domain Health to review parameters, response fields, examples, status codes, and supported operation modes.
Unknown or partial means we could not fully confirm the result. Keep the status, confidence, freshness and any limits in mind when you act on it.
The price depends on the check and the mode you choose. The API reference shows the current credit cost, whether you need an API key, and any per-item pricing.
Used by people at these companies