Domains

Get detailed information about a domain you own

Returns comprehensive information about a domain: status, purchase date, expiry, payment method, security lock, WHOIS privacy, auto-renew status, and registration dates. The registrar object may be null if extended data is unavailable.

get/api/domains/{domain}

Request

  • Base URL: https://domani.run
  • URL: https://domani.run/api/domains/{domain}
  • Auth: HTTP bearer

Path parameters

domainstring required
Example:mysite.com

Domain name you own

Response

Domain details

domainstring required
status'active' | 'expired' | 'pending' required
auto_renewboolean required

Whether auto-renew is enabled

purchased_atstring date-time required
expires_atstring date-time required
days_until_expiryinteger required

Days until domain expiry

renewal_pricenumber nullable required

What one year of renewal costs in USD at the registrar that holds the domain; renewing N years costs N times this. Null when domani cannot renew the domain or its price is unknown.

payment_method'card' | 'x402' | 'crypto' required

How the domain was paid for

payment_txstring nullable

On-chain tx hash (USDC payments)

registrant'customer' | 'domani' | 'unknown' required

Who the registry lists as the domain's registrant. customer: your own contact details (from set_contact). domani: Domani's default contact, holding the domain on your behalf until you add yours with set_contact, which makes you the registrant. unknown: not checked yet. WHOIS privacy hides the details either way.

registrar_status'connected' | 'unavailable' | 'external' required

Whether live registrar data was refreshed or is managed externally

registrar_checked_atstring date-time required

When the registrar refresh was attempted

Example response

{
  "domain": "mysite.com",
  "renewal_price": 107
}

Changes

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