Renew Domain

Renewing an Active Domain: Extends the registration limit. The internal period dynamically computes multiplying out the getPriceForPeriod() values logic from the database, subtracting from the USD wallet and immediately routing a transaction request to Dynadot. Automatically adjusts the next_due_date by your exact requested years, and calculates a next_invoice_date trailing sequentially by 30 days (-30 days interval).

Endpoint:POST /{id}/renew

Parameters:

  • id (required, URL parameter): The local ID of the domain. Used to verify wallet transactions logic.
  • period (required, integer, min 1, max 6): Numeric extension time in years.

Example Request:

curl -X POST "https://umva.net/api/domain/123/renew"
-H "X-API-Key: your_api_key_here"
-H "Content-Type: application/json"
-d '{"period": 1}'

Success Response Example (HTTP 200):

{
"success": true,
"message": "Domain renewed successfully!",
"data": {
"domain": "example.com",
"period": "1 year(s)",
"amount_charged": 10.99,
"new_expiry_date": "2025-10-12"
}
}

Error Response Example (Insufficient Balance - HTTP 400):

{
"success": false,
"message": "Insufficient USD balance."
}