Sign in

v1

latestOpenAPI 3.1.02026-07-2671111437.2 KB
Transfers

Create Transfer

Initiates a domain transfer into your name.com account from another registrar. You must provide the domain name and its valid transfer authorization code (EPP code). The domain must not be locked or under any transfer restrictions (e.g. clientTransferProhibited). If successful, the transfer is submitted and tracked through the ICANN transfer process. Once a transfer has been created, you can track its progress via the GetTransfer endpoint. Transfer pricing: Omit purchasePrice for standard (non-premium) transfers. For premium transfers, pass transferPrice from Get Pricing For Domain as purchasePrice. If sent, it must match Get Pricing transferPrice exactly or the request will fail. Premium transfers without purchasePrice will fail. See the Domain pricing guide for how Get Pricing transferPrice relates to the years query parameter.

post/core/v1/transfers

Request body

authCodestring required

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

domainNamestring required

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

privacyEnabledboolean

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.

purchasePricenumber 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 request

{
  "authCode": "ABC123",
  "domainName": "example.com",
  "privacyEnabled": true,
  "purchasePrice": 12.99
}

Response

A successful response.

orderinteger required

Order is an identifier for this purchase.

totalPaidnumber double required

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

Example response

{
  "order": 12345,
  "totalPaid": 12.99,
  "transfer": {
    "domainName": "example.com",
    "email": "admin@example.com",
    "status": "pending_transfer"
  },
  "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"
    ]
  }
}