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."
}