Home
/
API reference
/
API reference
/
Domain

Domain renew

EPP API · Updated 2023-09-26

Description

The domain renew command extends the current registration period. The registration period value is always a time unit of one or more years. The possible registration period values depend on the respective TLD.

Note

If a domain has the status pending delete and you send a domain renew command with a domain registration period value of 0, the cancelation is removed and the domain continues to exist normally. In this case the response is asynchronous.

XML example

<epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
    <command>
        <renew>
            <domain:renew xmlns:domain="urn:ietf:params:xml:ns:domain-1.0">
                <domain:name>example.com</domain:name>
                <domain:curExpDate>2020-05-22</domain:curExpDate>
                <domain:period unit="y">1</domain:period>
            </domain:renew>
        </renew>
        <clTRID>ABC-12345</clTRID>
    </command>
</epp>

<epp xmlns="urn:ietf:params:xml:ns:epp-1.0" xmlns:domain="urn:ietf:params:xml:ns:domain-1.0">
    <response>
        <result code="1001">
            <msg lang="en">Command completed successfully; action pending</msg>
        </result>
        <resData>
            <domain:renData>
                <domain:name>example.com</domain:name>
            </domain:renData>
        </resData>
        <extension />
        <trID>
            <clTRID>ABC-12345</clTRID>
        </trID>
    </response>
</epp>