ResellerHQ
Log inTry the sandbox free
GuidesAPI reference
Domains

Quote a restore

GET
/v1/domains/{id}/restore-quote

What bringing this domain back out of redemption would cost you. A restore costs many times a renewal and the registry usually charges a year with it, so read this before committing. Only a domain in redemption can be quoted.

Authorization

apiKey
headerAuthorizationBearer <token>

An API key from the Developers page. rhq_test_ keys reach the sandbox, rhq_live_ keys the live side.

Path Parameters

id*string

Response Body

What a restore of this domain would cost

application/json
  1. response

What a restore of this domain would cost

cost*integer

The restore itself, in minor units

Range0 <= value
renewalYears*integer

How many years the registry charges along with the restore; 0 for none

Range0 <= value
renewalCost*integer

What those years cost, in minor units; 0 when none are charged

Range0 <= value
total*integer

What your wallet is charged for the restore, in minor units

Range0 <= value
unknown*boolean

Set when the registrar could not price the restore and total comes from the catalogue instead. Still chargeable, but the figure may move

curl -X GET "https://example.com/v1/domains/dom_01K6XJ4Q8ZT3M9R5V2B7WDHNCA/restore-quote"
{  "cost": 1440,  "renewalYears": 1,  "renewalCost": 1440,  "total": 5276,  "unknown": true}

Resend the registrant validation email POST

For a domain stuck in `pending_validation`: asks the registrar to send the registrant another copy of the validation email. Only the registrant's own link in that email can clear the hold; this never changes the domain itself.

Restore a domain POST

Brings a domain in redemption back and charges your wallet the restore price, including the year the registry charges with it. Quote it first with `GET /v1/domains/{id}/restore-quote`. The domain comes back `active` with its new expiry date.