Domains

Plan how to adopt an existing domain

Read-only inspection of an existing domain before connecting or transferring it. Returns the current registrar, authoritative nameservers, DNS provider, DNSSEC state, account state, transfer price, safety invariants, and exact next API actions. Call this before requesting an EPP code. Connecting leaves registrar and DNS unchanged. Transferring preserves nameservers and does not migrate DNS.

get/api/domains/adoption-plan

Request

  • Base URL: https://domani.run
  • URL: https://domani.run/api/domains/adoption-plan
  • Auth: bearerAuth (a scheme the document does not define)

Query parameters

domainstring required

Existing domain to inspect, e.g. mysite.com

Response

Versioned domain adoption plan

version1 required
domainstring required
registeredboolean required
account_state'untracked' | 'connected' | 'managed' | 'owned_by_another' required
recommended_action'acquire' | 'connect' | 'transfer_preserving_dns' | 'none' required
invariantsstring[] required
warningsstring[] required

Example response

{
  "current": {
    "dns_provider": "cloudflare"
  },
  "options": {
    "transfer": {
      "guidance": {
        "managed_via": "vercel"
      }
    }
  }
}

Changes

No recorded changes to this operation across all 2 revisions of this API.