registrar renewal

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

Request

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"
  }
}

Changes

    • info

      api operation id domainRenew removed and replaced with renewDomain

    • breaking

      the request property became required

    • info

      the response property became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status