Skip to content
Coritan Docs

Renew a domain

Renew a domain registered with Coritan for one to ten years, or turn on auto-renew so it renews before it expires.

View as Markdown

Renew a domain to extend its registration past its expiry date. You can renew it by hand for 1–10 years at a time, or leave auto-renew on so that Coritan renews it before it expires. When a domain expires, its registry can stop it resolving and later release it for anyone to register.

  • The domain must be registered with Coritan. For a domain registered elsewhere, renew it at that registrar.
  • The registration must be active. See Troubleshooting when it is not.
  1. In the dashboard, go to Websites, open the domain and select the Settings tab.
  2. In the Renewal card, choose how many years to add, from 1 to 10.
  3. Select Renew domain.

The dashboard confirms the renewal. The Expires date updates once Coritan next reads the registration back from the registry.

  1. On the domain's Settings tab, find the Domain options card.
  2. Turn Auto-renew on or off.

With auto-renew on, Coritan renews the domain for one year when it is within 14 days of its expiry date. It tries again the next day when a renewal fails. With auto-renew off, Coritan emails you 30, 14, 7, 3 and 1 day before the domain expires.

The Registration card on the Settings tab shows the new Expires date and whether Auto-renew is on. In the Websites list, the Registrar column shows the Auto-renew badge, or Manual renewal.

Registration not found or not active
The dashboard renews only a registration whose status is active. Within 30 days of its expiry date a registration is expiring_soon, and once the registry reports it expired it is expired. Contact support to renew a domain in either state.
Could not save the Auto-renew setting
The switch could not be changed. The registration may not be active, or the registry did not answer. Try again later.
Renewal failed: …
The registry refused the renewal or did not answer. The expiry date has not changed. Try again later.
Duration must be between 1 and 10 years
The API accepts a duration from 1 to 10.

Renew registration 7 for two years. The body's duration is 1 when you leave it out:

Shell
curl -X POST https://api.coritan.com/api/v1/domains/registrations/7/renew \
  -H "Authorization: Bearer $CORITAN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"duration": 2}'
JSON
{"message": "Domain renewed successfully", "domain": "example.com", "new_expiry": "2029-09-16T10:04:00+00:00"}

The answer is 202, and new_expiry is the date the registry reported, or null when it reported none. Turn auto-renew on or off with enabled:

Shell
curl -X PUT https://api.coritan.com/api/v1/domains/registrations/7/auto-renew \
  -H "Authorization: Bearer $CORITAN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"enabled": false}'
JSON
{"message": "Auto-renew disabled", "domain": "example.com"}

API operations on this page

MethodPathWhat it does
POST/api/v1/domains/registrations/{reg_id}/renewRequest domain renewal
PUT/api/v1/domains/registrations/{reg_id}/auto-renewToggle auto-renewal for a domain