Skip to content

Renew

Purpose⚓

Extend the Expiry Date of a Domain Name Record for one Registration Period.

Authority⚓

Only the Managing AR of a Domain Name Record can submit a Renew DomainRequest.

Timing⚓

Domain can be renewed for up to five years. Any renewal request submitted to the registry that goes beyond the five-year maximum time, will be rejected with an error message indicating that the Domain Name renewal exceeds the allowed maximal registration period.

It is possible to renew a domain that have four years and three month to expiration date for one year only.

Result⚓

Upon the completion of the Renew Domain Request, request is processed immediately and the Expiry Date of the Domain Name will be extended by one Registration Period.

Code Example⚓

<?xml version="1.0" encoding="UTF-8"?>
<epp>
    <command>
        <renew>
            <domain:renew>
                <domain:name>example.co.il</domain:name>
                <domain:period unit="y">2</domain:period>
            </domain:renew>
        </renew>
        <clTRID>AB-123233</clTRID>
    </command>
</epp>

Legend⚓

  • <domain:renew>: Defines that the desired Registration Action, renewal of a Domain, where:
    • <domain:name>: Defines the Domain Name to be Renewed.
    • <domain:period ...>: The renewal period requested (from Expiry Date), expressed in Registration Units. The Expiry Date following the renewal request may not exceed the Maximal Registration Period, counted from the date of submission of the renewal request. A request to renew the registration beyond the Maximal Registration Period will result in an error.
    • <clTRID>: Defines the AR transaction identifier.

Tags occurrence table⚓

Tag Occurrences
(MIN-MAX)		 Size + Remarks
<epp> 1
<command> 1
<renew> 1
<domain:renew> 1
<secDNS:name> 1 Domain name is mandatory, must be a domain owned by the requesting registrar. Must not be suspended.
<secDNS:period> 1 1-5 years
<clTRID> 1 Must start with 2 capital letters representing the registrar, followed by a hyphen (-) and a string of numbers. Must be unique per request. Total length may not exceed 30 characters.

Additional Response Data (<resData> block) – in a SUCCESS message⚓

The API Server's response upon the successful completion of a Renew Domain Request:

<?xml version="1.0" encoding="UTF-8"?>
<epp>
    <response>
        <result>
            <code>1000</code>
            <msg>Command completed successfully (domain requestid=D202742)</msg>
        </result>
        <resData>
            <domain:renData>
                <domain:name>example.co.il</domain:name>
                <domain:requestID>202742</domain:requestID>
                <domain:exDate>2008-11-03T10:59:44.000Z</domain:exDate>
            </domain:renData>
        </resData>
        <trID>
            <clTRID>BL-5</clTRID>
            <svTRID>ISOCIL-BL148 20051103110301</svTRID>
        </trID>
    </response>
</epp>

Response Legend⚓

  • <domain:renData>: Information on the renewal of the Domain Name Record, where:
    • <domain:name>: Specifies the Domain Name Record renewed.
    • <domain:requestID>: Number of the request ID
    • <domain:exDate>: Specifies the expiry time of the Domain Name, in XML dateTime format.