v2

latestOpenAPI 3.1.0raw.githubusercontent.com2026-04-12308185.7 KB
domains

Return and refund a domain

Return the domain to Unstoppable Domains so it is once again considered available for registering. The amount previously added to your running balance will be removed after successfully returning a domain.

Returns are only allowed within 14 days of the original registration date, per our return policy.

delete/domains/{name}

Path parameters

namestring required

Query parameters

$previewboolean

Allows simulating the operation creation (when set to true), without actually starting any processing. This can be used to validate the operation will be permitted and get a preview of the initial outcome.

When used, the operation in the response will have PREVIEW for all id and status values.

Response

@type'unstoppabledomains.com/partner.v3.DomainOperationResult' required

Example response

{
  "operation": {
    "id": "op-4abb409c-9283-4589-bd36-d27a757a2165",
    "domain": "matt.crypto",
    "lastUpdatedTimestamp": 1684356429790,
    "dependencies": [
      {
        "id": "bc-2db427bd-5613-40c7-85b1-ab38beed0ed0",
        "parameters": {
          "initialRecords": {
            "crypto.ETH.address": "0xb4783AeF93923a2d4eEA29C84f347F26E62e4321",
            "crypto.MATIC.version.MATIC.address": "0xb4783AeF93923a2d4eEA29C84f347F26E62e5678",
            "crypto.MATIC.version.ERC20.address": "0xb4783AeF93923a2d4eEA29C84f347F26E62e0921"
          },
          "toAddress": "0xb4783AeF93923a2d4eEA29C84f347F26E62e4321"
        }
      }
    ]
  }
}