Skip to main content
POST
/
core
/
v1
/
transfers
/
internal
/
in
Create Internal Transfer In
curl --request POST \
  --url https://api.dev.name.com/core/v1/transfers/internal/in \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "domainName": "example.com",
  "authCode": "ABC123",
  "contacts": {}
}
'
{
  "domainName": "example.com",
  "createDate": "2023-01-15T14:30:00Z",
  "expireDate": "2025-01-15T14:30:00Z",
  "autorenewEnabled": true,
  "locked": true,
  "privacyEnabled": true,
  "contacts": {
    "admin": {
      "firstName": "John",
      "lastName": "Doe",
      "companyName": "Example Inc.",
      "address1": "123 Main Street",
      "address2": "Suite 400",
      "city": "New York",
      "state": "NY",
      "zip": "10001",
      "country": "US",
      "email": "john.doe@example.com",
      "phone": "+15551234567",
      "fax": "+15557654321",
      "isVerified": true,
      "verificationId": 12345
    },
    "billing": {
      "firstName": "John",
      "lastName": "Doe",
      "companyName": "Example Inc.",
      "address1": "123 Main Street",
      "address2": "Suite 400",
      "city": "New York",
      "state": "NY",
      "zip": "10001",
      "country": "US",
      "email": "john.doe@example.com",
      "phone": "+15551234567",
      "fax": "+15557654321",
      "isVerified": true,
      "verificationId": 12345
    },
    "registrant": {
      "firstName": "John",
      "lastName": "Doe",
      "companyName": "Example Inc.",
      "address1": "123 Main Street",
      "address2": "Suite 400",
      "city": "New York",
      "state": "NY",
      "zip": "10001",
      "country": "US",
      "email": "john.doe@example.com",
      "phone": "+15551234567",
      "fax": "+15557654321",
      "isVerified": true,
      "verificationId": 12345
    },
    "tech": {
      "firstName": "John",
      "lastName": "Doe",
      "companyName": "Example Inc.",
      "address1": "123 Main Street",
      "address2": "Suite 400",
      "city": "New York",
      "state": "NY",
      "zip": "10001",
      "country": "US",
      "email": "john.doe@example.com",
      "phone": "+15551234567",
      "fax": "+15557654321",
      "isVerified": true,
      "verificationId": 12345
    }
  },
  "nameservers": [
    "ns1.example.com",
    "ns2.example.com"
  ],
  "locks": [
    "clientTransferProhibited",
    "clientHold"
  ],
  "renewalPrice": 12.99
}

Documentation Index

Fetch the complete documentation index at: https://docs.name.com/llms.txt

Use this file to discover all available pages before exploring further.

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

Request body for transferring a domain from another name.com account into the authenticated reseller (gaining) account.

​
domainName
string
required

Fully qualified domain name to transfer in. The domain must be registered in another name.com account (the losing account).

Minimum string length: 1
Example:

"example.com"

​
authCode
string
required

Transfer authorization code (EPP/auth code) for the domain. The losing account holder must obtain this code from the name.com dashboard; it is not exposed by this API for the losing account.

Minimum string length: 1
Example:

"ABC123"

​
contacts
object

WHOIS contacts to apply after the transfer. If omitted, the gaining account's default contacts are applied. If provided, include all roles with complete fields (same rules as Set Contacts). A registrar contact-change transfer lock may apply according to the gaining account's settings, consistent with the Set Contacts endpoint.

Response

The domain was accepted into the gaining account. The response body matches the domain resource representation used elsewhere in the API (same shape as Get Domain / Set Contacts).

The response format for a domain.

​
domainName
string
required

The punycode-encoded value of the domain name.

Example:

"example.com"

​
createDate
string<date-time>
required
read-only

The date and time when the domain was created at the registry.

Example:

"2023-01-15T14:30:00Z"

​
expireDate
string<date-time>
required
read-only

The date and time when the domain will expire.

Example:

"2025-01-15T14:30:00Z"

​
autorenewEnabled
boolean
required

Indicates whether the domain is set to renew automatically before expiration.

Example:

true

​
locked
boolean
required

Indicates if the domain is transfer locked, preventing transfers to another registrar.

Example:

true

​
privacyEnabled
boolean
required

Indicates if Whois Privacy is enabled for this domain.

Example:

true

​
contacts
object
required

Contacts stores the contact information for the roles related to domains.

​
nameservers
string[]
required

The list of nameservers assigned to this domain. If unspecified, it defaults to the account's default nameservers.

Example:
["ns1.example.com", "ns2.example.com"]
​
locks
string[]
read-only

List of all registry locking statuses currently applied to the domain. Use this to see which locks are active (e.g. clientTransferProhibited, clientHold). Empty when the domain has no locks applied.

Example:
["clientTransferProhibited", "clientHold"]
​
renewalPrice
number<double>
read-only

The cost to renew the domain. This may be required for the RenewDomain operation.

Example:

12.99