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",
    "email": "admin@example.com",
    "status": "pending_transfer"
  }
}

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.

​
authCode
string
required

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

Minimum length: 1
Example:

"ABC123"

​
domainName
string
required

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

Minimum length: 1
Example:

"example.com"

​
privacyEnabled
boolean

PrivacyEnabled is a flag on whether to purchase Whois Privacy with the transfer.

Example:

true

​
purchasePrice
number

PurchasePrice is the amount to pay for the transfer of the domain. If privacy_enabled is set, the regular price for Whois Privacy will be added automatically. If VAT tax applies, it will also be added automatically. PurchasePrice is required if the domain to transfer is a premium domain.

Example:

12.99

Response

A successful response.

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

​
order
integer
required

Order is an identifier for this purchase.

Example:

12345

​
totalPaid
number
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.

⌘I