Skip to main content
GET
/
core
/
v1
/
transfers
/
{domainName}
Get Transfer
curl --request GET \
  --url https://api.dev.name.com/core/v1/transfers/{domainName} \
  --header 'Authorization: Basic <encoded-value>'
{
  "domainName": "example.com",
  "status": "pending_transfer",
  "email": "[email protected]"
}

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.

Path Parameters

​
domainName
string
required

DomainName is the domain you want to get the transfer information for.

Response

A successful response.

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

​
domainName
string
required

DomainName is the domain to be transfered to name.com.

Example:

"example.com"

​
status
enum<string>
required

The updated status of the domain transfer. The transfer status will be one of the following values:

  • canceled: The transfer has been canceled by the user.
  • canceled_pending_refund: The transfer has been canceled by the user, and a refund for the price is being processed.
  • completed: The transfer has completed.
  • failed: The transfer has failed, and will not be retried.
  • pending: The transfer has been requested, and is pending.
  • pending_insert: The transfer has completed and the domain will soon be inserted into the account.
  • pending_new_auth_code: A new authcode is required to complete the transfer.
  • pending_transfer: The transfer has been requested, and is pending.
  • pending_unlock: The domain to be transferred is currently in a locked state at the losing registrar, and will begin processing once the lock has been removed.
  • rejected: The transfer has been rejected at the losing registrar and will not be retried.
  • submitting_transfer: The transfer has been initiated and will soon be submitted to the registry.
Available options:
canceled,
canceled_pending_refund,
completed,
failed,
pending,
pending_insert,
pending_new_auth_code,
pending_transfer,
pending_unlock,
rejected,
submitting_transfer
Example:

"pending_transfer"

​
email
string<email>

Email is the email address that the approval email was sent to. Not every TLD requries an approval email. This is usually pulled from Whois.

Example:

"[email protected]"