Skip to main content

​
Endpoint

POST /v1/domain
Cost: 2 credits per request

​
Request body

{
  "domain": "acme.com"
}
FieldTypeRequiredDescription
domainstringYesDomain name to look up (without protocol — e.g. acme.com not https://acme.com)

​
Example request

curl -X POST https://api.datalinkapis.com/v1/domain \
  -H "Authorization: Bearer dl_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "domain": "acme.com" }'

​
Response

{
  "domain": "acme.com",
  "valid": true,
  "registered": true,
  "registrar": "GoDaddy",
  "created_date": "1997-04-12",
  "expiry_date": "2026-04-12",
  "age_days": 10580,
  "dns_healthy": true,
  "mx_found": true,
  "spf_found": true,
  "dmarc_found": true,
  "disposable": false,
  "parked": false,
  "safety_score": 92,
  "credits_used": 2
}

​
Response fields

FieldTypeDescription
domainstringThe domain that was checked
validbooleanWhether the domain is syntactically valid and registered
registeredbooleanWhether the domain has an active registration
registrarstringName of the registrar
created_datestringRegistration date (ISO 8601)
expiry_datestringExpiry date (ISO 8601)
age_daysintegerAge of the domain in days
dns_healthybooleanWhether DNS records resolve correctly
mx_foundbooleanWhether at least one MX record is present
spf_foundbooleanWhether an SPF TXT record exists
dmarc_foundbooleanWhether a DMARC policy record exists
disposablebooleanWhether the domain is associated with disposable email services
parkedbooleanWhether the domain appears to be parked with no active content
safety_scoreintegerComposite safety score 0–100. Higher = safer.
credits_usedintegerCredits deducted — always 2 for this endpoint

​
Use cases

  • Vendor due diligence — assess domain age and safety before engaging with a new supplier
  • Lead enrichment — understand the health and maturity of a prospect’s domain
  • Email infrastructure check — verify SPF and DMARC records are in place before a campaign