v1

latestSwagger 2.02026-07-136573327.3 KB

Retrieve details for the specified Domain

get/v1/domains/{domain}

Path parameters

domainstring required

Domain name whose details are to be retrieved

Headers

X-Shopper-Idstring

Shopper ID expected to own the specified domain

Response

Request was successful

authCodestring required

Authorization code for transferring the Domain

createdAtstring date-time required

Date and time when this domain was created

deletedAtstring date-time

Date and time when this domain was deleted

transferAwayEligibleAtstring date-time

Date and time when this domain is eligible to transfer

domainstring required

Name of the domain

domainIdnumber double required

Unique identifier for this Domain

expirationProtectedboolean required

Whether or not the domain is protected from expiration

expiresstring date-time

Date and time when this domain will expire

exposeRegistrantOrganizationboolean

Whether or not the domain registrant contact organization field should be shown in the WHOIS

exposeWhoisboolean

Whether or not the domain contact details should be shown in the WHOIS

holdRegistrarboolean required

Whether or not the domain is on-hold by the registrar

lockedboolean required

Whether or not the domain is locked to prevent transfers

nameServersstring[] required

Fully-qualified domain names for DNS servers

privacyboolean required

Whether or not the domain has privacy protection

registrarCreatedAtstring iso-datetime

Date and time when this domain was created by the registrar

renewAutoboolean required

Whether or not the domain is configured to automatically renew

renewDeadlinestring date-time required

Date the domain must renew on

statusstring required

Processing status of the domain <ul>

<li>ACTIVE - All is well</li> <li>AWAITING* - System is waiting for the end-user to complete an action</li> <li>CANCELLED* - Domain has been cancelled, and may or may not be reclaimable</li> <li>CONFISCATED - Domain has been confiscated, usually for abuse, chargeback, or fraud</li> <li>DISABLED* - Domain has been disabled</li> <li>EXCLUDED* - Domain has been excluded from Firehose registration</li> <li>EXPIRED* - Domain has expired</li> <li>FAILED* - Domain has failed a required action, and the system is no longer retrying</li> <li>HELD* - Domain has been placed on hold, and likely requires intervention from Support</li> <li>LOCKED* - Domain has been locked, and likely requires intervention from Support</li> <li>PARKED* - Domain has been parked, and likely requires intervention from Support</li> <li>PENDING* - Domain is working its way through an automated workflow</li> <li>RESERVED* - Domain is reserved, and likely requires intervention from Support</li> <li>REVERTED - Domain has been reverted, and likely requires intervention from Support</li> <li>SUSPENDED* - Domain has been suspended, and likely requires intervention from Support</li> <li>TRANSFERRED* - Domain has been transferred out</li> <li>UNKNOWN - Domain is in an unknown state</li> <li>UNLOCKED* - Domain has been unlocked, and likely requires intervention from Support</li> <li>UNPARKED* - Domain has been unparked, and likely requires intervention from Support</li> <li>UPDATED* - Domain ownership has been transferred to another account</li> </ul>

subaccountIdstring

Reseller subaccount shopperid who can manage the domain

transferProtectedboolean required

Whether or not the domain is protected from transfer