v1

latestOpenAPI 3.1.02026-07-2671111437.2 KB

Domains

Renew Domain

Renews an existing domain for an additional registration period. Include the domain name and renewal term. Omit purchasePrice for standard (non-premium) renewals. For premium renewals, pass renewalPrice from Get Pricing with matching years as purchasePrice. Renewal pricing is separate from Create Domain registration/acquisition pricing. This is typically used to extend ownership before a domain’s expiration.

post/core/v1/domains/{domainName}:renew

Path parameters

domainNamestring required

DomainName is the domain to renew.

Request body

purchasePricenumber double

PurchasePrice is the total USD renewal cost for the requested years, before VAT. VAT is applied when applicable and must not be included here. If sent, must match Get Pricing renewalPrice exactly. Omit for standard (non-premium) renewals. Required for premium renewals — use renewalPrice from Get Pricing with matching years.

yearsinteger

Years specifies the renewal term in years. Defaults to each TLD's minimum registration term if omitted — usually 1 year (2 for .ai). Must be a supported registration term for the TLD (commonly 1–10 years). For premium renewals, call Get Pricing with the same years value.

Example request

{
  "purchasePrice": 10.99,
  "years": 3
}

Response

A successful response.

orderinteger

totalPaidnumber double

TotalPaid is the total amount paid, including VAT.

Example response

{
  "domain": {
    "domainName": "example.com",
    "createDate": "2023-01-15T14:30:00Z",
    "expireDate": "2025-01-15T14:30:00Z",
    "autorenewEnabled": true,
    "locked": true,
    "locks": [
      "clientTransferProhibited",
      "clientHold"
    ],
    "transferLockExpiresAt": "2023-03-16T14:30:00Z",
    "privacyEnabled": true,
    "contacts": {
      "admin": {
        "firstName": "John",
        "lastName": "Doe",
        "companyName": "Example Inc.",
        "address1": "123 Main Street",
        "address2": "Suite 400",
        "city": "New York",
        "state": "NY",
        "zip": "10001",
        "country": "US",
        "email": "john.doe@example.com",
        "phone": "+15551234567",
        "fax": "+15557654321",
        "isVerified": true,
        "verificationId": 12345
      },
      "billing": {
        "firstName": "John",
        "lastName": "Doe",
        "companyName": "Example Inc.",
        "address1": "123 Main Street",
        "address2": "Suite 400",
        "city": "New York",
        "state": "NY",
        "zip": "10001",
        "country": "US",
        "email": "john.doe@example.com",
        "phone": "+15551234567",
        "fax": "+15557654321",
        "isVerified": true,
        "verificationId": 12345
      },
      "registrant": {
        "firstName": "John",
        "lastName": "Doe",
        "companyName": "Example Inc.",
        "address1": "123 Main Street",
        "address2": "Suite 400",
        "city": "New York",
        "state": "NY",
        "zip": "10001",
        "country": "US",
        "email": "john.doe@example.com",
        "phone": "+15551234567",
        "fax": "+15557654321",
        "isVerified": true,
        "verificationId": 12345
      },
      "tech": {
        "firstName": "John",
        "lastName": "Doe",
        "companyName": "Example Inc.",
        "address1": "123 Main Street",
        "address2": "Suite 400",
        "city": "New York",
        "state": "NY",
        "zip": "10001",
        "country": "US",
        "email": "john.doe@example.com",
        "phone": "+15551234567",
        "fax": "+15557654321",
        "isVerified": true,
        "verificationId": 12345
      }
    },
    "nameservers": [
      "ns1.example.com",
      "ns2.example.com"
    ],
    "renewalPrice": 12.99
  },
  "totalPaid": 5.95
}