Domain Renewal
POST /order/domains/renew
Renews a domain name.
This operation changes registry/account state and may incur a charge.
Authentication
Send the username and token headers described in Authentication.
Request Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
domain | string | Yes | Domain to renew. | example.invalid |
regperiod | integer | Yes | Requested renewal period. Supported values require validation. | 1 |
Complete Request
curl --request POST \
--url "https://my.register.ly/modules/addons/DomainsReseller/api/index.php/order/domains/renew" \
--header "Content-Type: application/x-www-form-urlencoded" \
--header "username: reseller@example.com" \
--header "token: <generated-token>" \
--data-urlencode "domain=example.invalid" \
--data-urlencode "regperiod=1"
The .invalid top-level domain is deliberately non-registrable, so the request cannot renew a real domain. Replace it only with an approved controlled test domain.
Success Response (200)
"success"
Error Responses
No renewal error status or response body is defined in the published OpenAPI.
Notes
VALIDATION REQUIRED: Supported renewal periods.
VALIDATION REQUIRED: Renewal behavior for expired domains.
VALIDATION REQUIRED: Redemption-period behavior.
VALIDATION REQUIRED: Whether renewal requests are idempotent.
VALIDATION REQUIRED: Whether "success" means final registry renewal or successful request processing.
Do not automatically retry a renewal after a timeout or unknown response until the current domain state has been verified. A repeated request may have financial or registration-period consequences if the original operation succeeded.