Get live details

GET /v1/domain-purchases/:id/details

Returns both the stored purchase row AND a live snapshot from the registrar. Use this to power a domain-detail page in Acme's dashboard with accurate nameserver, expiry, and lock status.

Request

curl https://api.domainee.dev/v1/domain-purchases/f8a0c1b9-…/details \
  -H "Authorization: Bearer $DOMAINEE_API_KEY"

Response — 200 OK

{
  "purchase": { /* same shape as GET /:id */ },
  "live": {
    "hostname": "janesbakery.com",
    "registrarDomainId": "182739",
    "status": "active",
    "createdAt": "2026-05-17T15:42:11.000Z",
    "expiresAt": "2027-05-17T15:42:11.000Z",
    "autoRenewAtRegistrar": false,
    "whoisPrivacyEnabled": true,
    "registrarLocked": true,
    "nameservers": [
      "dns1.registrar-servers.com",
      "dns2.registrar-servers.com"
    ]
  }
}

Field	Notes
status	active, expired, locked, or unknown.
registrarLocked	Anti-hijack lock at the registrar. On by default for new domains.
whoisPrivacyEnabled	Whether the registrant contact is hidden in public WHOIS.
nameservers	The current authoritative nameservers. Default points at the registrar; updated by PUT /:id/nameservers.
autoRenewAtRegistrar	Whether the registrar will auto-renew. Domainee manages renewals itself (see the patch endpoint), so this is informational only.

Cost

This endpoint makes a live call to the registrar. It's read-only, but it's not as cheap as GET /:id (which only hits Mongo). Cache it on your side if you're rendering a dashboard.