Renewal
Extends the registration term of an existing domain order before it expires.
Ownership check: The order_id must belong to a domain under your partner account. Orders from other partners will be rejected with a 422.
Expiry verification: The expiry_timestamp must exactly match the domain’s current expiry as a Unix epoch timestamp. This acts as an optimistic concurrency check to prevent accidental double-renewals. Retrieve the current value from GET /api/v1/domains/orders before submitting.
Billing: A billing settlement is performed automatically before the renewal is submitted to the registry. If the settlement fails, the renewal will not proceed.
Duration: Renewals are accepted for 1–9 years. Some TLDs enforce a minimum renewal period (e.g. 2 years for .ai) — if the renewal fails for a short duration, try increasing the duration.
Timing: Renew before the domain expires. Domains in Pending Delete Restorable status may require a restore instead of a standard renewal.
Authorizations
A personal access token. Obtain one from the dashboard under Settings > API Key. Include it in the Authorization header as Bearer <token>. Unauthenticated requests to protected routes return 401 Unauthorized.
Body
Order ID of the domain registration to renew.
124680932
Renewal term in years (1–9).
1 <= x <= 91
Current expiry of the domain as a Unix epoch timestamp. Must match exactly — use GET /api/v1/domains/orders to retrieve it.
1835699117