---
title: "Return and refund a domain"
method: DELETE
path: "/domains/{name}"
tags: ["domains"]
---

# Return and refund a domain

`DELETE /domains/{name}`

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.

## Path parameters

- `name` string, required

## Query parameters

- `$preview` boolean — 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 `200`

- DomainOperationResponse
  - `@type` 'unstoppabledomains.com/partner.v3.DomainOperationResult', required
  - `operation` OperationCheckResponse, required
    - `id` string, required
    - `@type` 'unstoppabledomains.com/partner.v3.Operation', required
    - `status` 'QUEUED' | 'SIGNATURE_REQUIRED' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'CANCELLED', required
    - `type` 'DOMAIN_CLAIM' | 'DOMAIN_UPDATE' | 'DOMAIN_RETURN' | 'WALLET_CREATE' | 'WALLET_UPDATE' | 'WALLET_VERIFY' | 'ACCOUNT_UPDATE', required
    - `domain` string
    - `lastUpdatedTimestamp` number, required
    - `dependencies` union[], required
      - union
        - MintSubOperationResponse
          - `id` string, required
          - `status` 'QUEUED' | 'SIGNATURE_REQUIRED' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'CANCELLED', required
          - `@type` 'unstoppabledomains.com/partner.v3.BlockchainOperation', required
          - `transaction` SubOperationTransactionResponse
            - `hash` string
            - `blockchain` 'MATIC' | 'ETH' | 'BASE', required
          - `type` 'MINT', required
          - `parameters` MintParametersResponse, required
            - `initialRecords` DomainRecords
            - `toAddress` string, required
        - UpdateRecordsSubOperationResponse
          - `id` string, required
          - `status` 'QUEUED' | 'SIGNATURE_REQUIRED' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'CANCELLED', required
          - `@type` 'unstoppabledomains.com/partner.v3.BlockchainOperation', required
          - `transaction` SubOperationTransactionResponse
            - `hash` string
            - `blockchain` 'MATIC' | 'ETH' | 'BASE', required
          - `type` 'UPDATE_RECORDS', required
          - `parameters` UpdateRecordsParametersResponse, required
            - `recordUpdates` DomainRecords, required
            - `resetRecords` boolean, required
        - TransferSubOperationResponse
          - `id` string, required
          - `status` 'QUEUED' | 'SIGNATURE_REQUIRED' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'CANCELLED', required
          - `@type` 'unstoppabledomains.com/partner.v3.BlockchainOperation', required
          - `transaction` SubOperationTransactionResponse
            - `hash` string
            - `blockchain` 'MATIC' | 'ETH' | 'BASE', required
          - `type` 'TRANSFER', required
          - `parameters` TransferParametersResponse, required
            - `fromAddress` string, required
            - `toAddress` string, required
            - `resetRecords` boolean, required
        - ReturnSubOperationResponse
          - `id` string, required
          - `status` 'QUEUED' | 'SIGNATURE_REQUIRED' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'CANCELLED', required
          - `@type` 'unstoppabledomains.com/partner.v3.BlockchainOperation', required
          - `transaction` SubOperationTransactionResponse
            - `hash` string
            - `blockchain` 'MATIC' | 'ETH' | 'BASE', required
          - `type` 'RETURN', required
        - WalletCreateSubOperationResponse
          - `id` string, required
          - `status` 'QUEUED' | 'SIGNATURE_REQUIRED' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'CANCELLED', required
          - `@type` 'unstoppabledomains.com/partner.v3.PlatformOperation', required
          - `result` WalletCreateResultResponse
            - `address` string, required
          - `type` 'WALLET_CREATE', required
        - WalletSetDefaultSubOperationResponse
          - `id` string, required
          - `status` 'QUEUED' | 'SIGNATURE_REQUIRED' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'CANCELLED', required
          - `@type` 'unstoppabledomains.com/partner.v3.PlatformOperation', required
          - `parameters` WalletSetDefaultParametersResponse, required
            - `address` string, required
          - `type` 'WALLET_SET_DEFAULT', required
        - WebhookCreateSubOperationResponse
          - `id` string, required
          - `status` 'QUEUED' | 'SIGNATURE_REQUIRED' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'CANCELLED', required
          - `@type` 'unstoppabledomains.com/partner.v3.PlatformOperation', required
          - `parameters` WebhookCreateParametersResponse, required
            - `type` 'OPERATION_FINISHED' | 'OPERATION_ACTION_REQUIRED', required
            - `url` string, uri, required
          - `result` WebhookCreateResultResponse
            - `id` string, required
          - `type` 'WEBHOOK_CREATE', required
        - WebhookDeleteSubOperationResponse
          - `id` string, required
          - `status` 'QUEUED' | 'SIGNATURE_REQUIRED' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'CANCELLED', required
          - `@type` 'unstoppabledomains.com/partner.v3.PlatformOperation', required
          - `parameters` WebhookDeleteParametersResponse, required
            - `id` string, required
          - `type` 'WEBHOOK_DELETE', required

## Other responses

- `400`

---

[API](https://skmtc.net/unstoppabledomains/apis/web3-partner-api-v3.md) · [All operations](https://skmtc.net/unstoppabledomains/apis/web3-partner-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/unstoppabledomains/web3-partner-api-v3/revisions/8331236de8e8/schema)