Transfers

Get Transfer

Retrieves details of a specific domain transfer request.

get/core/v1/transfers/{domainName}

Request

  • Base URL: https://api.dev.name.com
  • URL: https://api.dev.name.com/core/v1/transfers/{domainName}
  • Auth: HTTP basic

Path parameters

domainNamestring required

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

Response

A successful response.

domainNamestring required

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

emailstring 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.

status'canceled' | 'canceled_pending_refund' | 'completed' | 'failed' | 'pending' | 'pending_insert' | 'pending_new_auth_code' | 'pending_registry_unlock' | 'pending_transfer' | 'pending_unlock' | 'rejected' | 'submitting_transfer' required

Terminal (finished; will not change):

  • completed: Completed.
  • failed: Failed.
  • canceled: Canceled by the user.
  • canceled_pending_refund: Canceled; refund processing.

Non-terminal (in progress; may change):

  • pending: Requested.
  • submitting_transfer: Being submitted to the registry.
  • pending_new_auth_code: New auth code required.
  • pending_unlock: Waiting for losing registrar unlock.
  • pending_registry_unlock: Waiting for registry unlock.
  • pending_transfer: Pending at the registry.
  • pending_insert: Transfer complete; domain will be added to the account.
  • rejected: Rejected at the losing registrar.

Example response

{
  "domainName": "example.com",
  "email": "admin@example.com",
  "status": "pending_transfer"
}

Changes

No recorded changes to this operation across all 1 revision of this API.