Skip to main content
POST
/
core
/
v1
/
transfers
Create Transfer
curl --request POST \
  --url https://api.dev.name.com/core/v1/transfers \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "authCode": "ABC123",
  "domainName": "example.com",
  "privacyEnabled": true,
  "purchasePrice": 12.99
}
'
{
  "order": 12345,
  "totalPaid": 12.99,
  "transfer": {
    "domainName": "example.com",
    "status": "pending_transfer",
    "email": "admin@example.com"
  },
  "warnings": {
    "message": "Domain has registry statuses that may prevent a successful transfer. Please ensure the domain is unlocked and eligible at the losing registrar.",
    "statuses": [
      "clientTransferProhibited",
      "clientUpdateProhibited"
    ]
  }
}

Authorizations

​
Authorization
string
header
required

Authenticate via HTTP Basic with your account username and API token. Examples use an explicit 'Authorization: Basic <base64(username:token)>' header; 'curl -u username:token' is equivalent. For sandbox, append "-test" to your username and use your sandbox token on api.dev.name.com.

Body

application/json

CreateTransferRequest passes the required transfer info to the CreateTransfer function.

CreateTransferRequest passes the required transfer info to the CreateTransfer function. See the Domain pricing guide for how purchasePrice relates to Get Pricing transferPrice.

​
authCode
string
required

AuthCode is the authorization code for the transfer. Not all TLDs require authorization codes, but most do.

Minimum string length: 1
Example:

"ABC123"

​
domainName
string
required

DomainName is the domain you want to transfer to name.com.

Minimum string length: 1
Example:

"example.com"

​
privacyEnabled
boolean

PrivacyEnabled is a flag on whether to purchase Whois Privacy with the transfer. If this flag is omitted from the request, the system will check the account's Whois Privacy auto-add settings. If auto-add is enabled in your account settings, Whois Privacy will be added by default, provided the TLD supports it.

Example:

true

​
purchasePrice
number<double>

PurchasePrice is the USD inbound transfer fee, before VAT. VAT is applied when applicable and must not be included here. If sent, must match Get Pricing transferPrice exactly or the request will fail.. Omit for standard (non-premium) transfers. Required for premium transfers — use transferPrice from Get Pricing.

Example:

12.99

Response

A successful response.

CreateTransferResponse returns the newly created transfer resource as well as the order information.

​
order
integer<int32>
required

Order is an identifier for this purchase.

Example:

12345

​
totalPaid
number<double>
required

TotalPaid is the total amount paid, including VAT and Whois Privacy.

Example:

12.99

​
transfer
object
required

Transfer contains all relevant data for a domain transfer to name.com.

​
warnings
object

Optional transfer warnings surfaced by the API when non-blocking registry statuses are detected.