Renew domain

POST

/domains/renew

This endpoint enables you to submit a request to renew a domain registration. Upon receiving the request, the system validates and accepts it, then processes the renewal by charging the wallet first, followed by completing the renewal with the registrar.

Request

Authorization

API Key

Add parameter in header

cmr-x-api-key

Example:

cmr-x-api-key: ********************

Body Params application/jsonRequired

Examples

Example 1Example 2

{
    "userId": "8J7HM04FRXUT4VK86128K6D25APS",
    "domains": [
        "hefty-minion.net",
        "sparkling-disk.info",
        "favorite-hydrolyse.name"
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

Example 1Example 2

curl --location --request POST 'https://customers.coldmailreseller.com/api/v1/integration/domains/renew' \
--header 'cmr-x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "userId": "8J7HM04FRXUT4VK86128K6D25APS",
    "domains": [
        "hefty-minion.net",
        "sparkling-disk.info",
        "favorite-hydrolyse.name"
    ]
}'

Responses

🟢200Success

application/json

Body

Examples

Single domainMultiple domainsPartial successEvery domain failed validation for renewal

{
  "status": 200,
  "message": "Renewal queued for 1 domain.",
  "data": [
    {
      "domainName": "acme.com",
      "domainId": "5J7HM04FRXMT7VK86128K6D25ASP",
      "years": 1,
      "renewalPrice": 21.99
    }
  ]
}

🟠422Unprocessable Entity

🟠404Not Found

Modified at 2026-04-03 08:40:37

Get domain renewal pricing

Enable or disable domain auto-renew