18 Domains API: How to renew a domain

This is a series of articles dedicated to demonstrating how to get acquainted with Openprovider Domains API methods. To get more information about our API in general, please use our documentation portal as your reference.

If you have chosen to have your domain name to be renewed automatically you won't need to worry about registration periods, your domains will be renewed automatically. Unless you haven't opted in for this option or your credit funds are insufficient the domain name will be removed on its expiration date in Openprovider.

In order to prevent a potential domain name loss you can explicitly renew it with the help of renewDomainRequest method. Some TLDs can be renewed at any given time, others, on the the other hand, only within a certain timeframe before their expiration date. Depending on the TLD you will receive a comprehensive answer from our API.

Entering Geo Fence iconUse endpoint path below. Base URL is determined by both the target environment and API version.
POST {base_url}/domains/{id}/renew

REQUEST VALUES

Name Type Description
domain string Required.
period integer Required.

REQUEST EXAMPLE

curl -X POST \
'https://api.openprovider.eu/v1beta/domains/123456/renew' \
-H 'Accept: */*' \
-H 'Authorization: ,Bearer 2f4c1c3a9******15d22b378a64' \
-H 'Connection: keep-alive' \
-H 'Content-Type: application/json' \
-d '{
"domain": {
"extension": "com",
"name": "domain",
},
"period": 2
}

RESPONSE EXAMPLE

{
"code": 0,
"data": {
"status": "ACT"
},
"desc": ""
}

If you do not want to renew the domain you can delete it or set it to not renew automatically before the expiration date in Openprovider.

Please refer to our renewal policies to get more information.

Was this article helpful?
Additional questions? Submit a request