DomainsTransfers

Cancel a domain transfer

DELETE
/v1/domains/transfers/{id}

Cancels a transfer that is still pending and gives the hold back in full.

Authorization

apiKey
headerAuthorizationBearer <token>

An API key from the Developers page. rhq_test_ keys reach the sandbox, rhq_live_ keys the live side.

Path Parameters

id*string

Response Body

Success

application/json
  1. response

Success

id*string
domain*string
status*string
Value in"pending""completed""rejected""cancelled""failed"
customerId*|

The customer this was bought for, if any

unitPrice*integer

What the transfer itself costs, in minor units

Range0 <= value
addsYear*boolean

Whether completing this transfer adds a year to the registration

paidTotal*integer

0 until the transfer completes, then unitPrice

Range0 <= value
subState*|

A plain-English sentence about the registrar’s own finer sub-state while pending - waiting for the registry, the losing registrar or the registrant’s own approval. Null once it is no longer pending

domainId*|

The domain this created once it completed. Null until then

createdAt*string
Formatdate-time
resolvedAt*|

When it finished, whichever way. Null while pending

curl -X DELETE "https://example.com/v1/domains/transfers/dtx_01K6XJ4Q8ZT3M9R5V2B7WDHNCA"
{  "id": "dtx_01K6XJ4Q8ZT3M9R5V2B7WDHNCA",  "domain": "northwind-telecom.com",  "status": "pending",  "customerId": "cus_01K6XJ4Q8ZT3M9R5V2B7WDHNCA",  "unitPrice": 1440,  "addsYear": true,  "paidTotal": 1440,  "subState": "string",  "domainId": "dom_01K6XJ4Q8ZT3M9R5V2B7WDHNCA",  "createdAt": "2026-10-07T11:04:31.000Z",  "resolvedAt": "2026-10-07T11:04:31.000Z"}