v1

latestOpenAPI 3.1.12026-07-17111158225.7 KB
registrar renewal

Renew a domain

Explicitly renews a domain, if the registry supports this function.

Your account must be active for this command to complete successfully. You will be automatically charged the renewal fee upon successful renewal, so please be careful with this command.

post/{account}/registrar/domains/{domain}/renewals

Path parameters

accountinteger required

The account id

domainstring required

The domain name or id

Request body

periodinteger required
premium_pricestring

Required as confirmation of the price, only if the domain is premium.

Example request

{
  "period": 2
}

Response

Domain renewal created

Example response

{
  "data": {
    "id": 1,
    "domain_id": 999,
    "period": 1,
    "state": "new",
    "created_at": "2016-12-09T19:46:45Z",
    "updated_at": "2016-12-09T19:46:45Z"
  }
}