Need help? Call Live Support at +31 (0) 38 453 07 59

Attention! You're currently using the OT&E environment.

Used to renew a domain

  • POSTMethod
  • /v2/domains/domainName/renewURL
  • application/jsonContent-Type
Name Type Description Restrictions
domainName String The domain name
  • Regular expression: ^(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)+(?:[a-z][a-z0-9-]{0,61}[a-z0-9])$
  • Minimum length: 3
  • Maximum length: 255
  • Registry specific restrictions may apply
Name Type Required / Optional Description Restrictions
quote Boolean Optional If true, validate the request and request a quote for the action
Name Type Required / Optional Description Restrictions
period String Required The period the domain has to be renewed for, if not specified the minimum renew length for the TLD will be used
  • Minimum length: 12
  • Maximum length: 120
billables List < billables > Optional Acknowledgment of billables for this request
Name Type Required / Optional Description Restrictions
product String Required The product
action Enum Required The action

Possible values:

  • CREATE
  • REQUEST
  • TRANSFER
  • RENEW
  • RESTORE
  • TRANSFER_RESTORE
  • UPDATE
  • REGISTRANT_CHANGE
  • LOCAL_CONTACT
  • NEGATIVE_MARKUP
  • PRIVACY_PROTECT
  • EXTRA_WILDCARD
  • EXTRA_DOMAIN
  • REGISTRY_LOCK
quantity Integer Optional The maximum quantity, default 1

Successful request

  • 200 OKHTTP Status
Name Type Required / Optional Description
domainName String Required The domain name
expiryDate Required The expiry date
  • 202 AcceptedHTTP Status
Name Type Required / Optional Description
domainName String Required The domain name
expiryDate Required The expiry date

Failed requests

Besides the generic errors these specific error responses can be expected.

Type Status Description
BillableAcknowledgmentNeededException 400 Bad Request
The domain name
If true, validate the request and request a quote for the action
The period the domain has to be renewed for, if not specified the minimum renew length for the TLD will be used
The product
The action
The maximum quantity, default 1

POST /v2/domains/domainName/renew
Content-Type: application/json

{}