Transfer a Domain Name

Use the OVHcloud public API to transfer your domain names

Last updated 21st July 2022

To follow this guide, make sure you are connected to OVHcloud API. You may find more information on the API introduction page if needed.

Table of Contents

Incoming transfer

An incoming transfer corresponds to transferring the domain name management from another registrar to OVHcloud. This is pretty much the same as a new domain name order, except that the domain is not listed as available since it is already owned.

If you are the domain owner, you may transfer its management to OVHcloud as follows.

  1. Fetch the confidential authorization code (sometimes referred to as "auth code" or "auth info") associated to your domain name on your current registrar dashboard.

  2. Order a transfer: this will consist in the same steps as ordering a new domain name.

    • Only the offer will differ, since the available action will be transfer (instead of create) and the pricing mode will be transfer-default.

    • Do not forget to add the authorization code to your order, as the AUTH_INFO configuration value.

    When the order is complete, it will generate a new DomainIncomingTransfer task.

  3. Monitor the evolution of the DomainIncomingTransfer task using the task API.

  4. If you did not add the authorization code to your order, or if it was invalid, the DomainIncomingTransfer task may result in error.

    In that case, use the task API to send the valid code with the authInfo argument key, then relaunch the task.

The transfer should be completed by the registry after a few days.

Outgoing transfer

We talk about outgoing transfer when a customer wishes to delegate the management of his domain name from OVHcloud to another regitrar. The following instructions describe the most common way to execute this transfer. However, this procedure may vary for some ccTLDs like .lu, .uk, .hk, ans so on... In this case, please consult registrar documentation.

Domain lock

A domain lock is a security that prevents your domain from being the target of attempts to transfer to another regitrar. It means that if this option is activated on your domain name, it cannot be transferred without first being unlocked. You can check what state your domain name is in by using the following route:

Parameter Required Default Description
serviceName yes Domain name

Example

GET /domain/xxx.ovh
{
   "transferLockStatus": "locked",
   "parentService": null,
   "nameServerType": "hosted",
   "offer": "gold",
   "whoisOwner": "12345678",
   "owoSupported": true,
   "lastUpdate": "2022-03-10T14:00:40+01:00",
   "glueRecordIpv6Supported": true,
   "domain": "xxx.ovh",
   "glueRecordMultiIpSupported": true,
   "dnssecSupported": true
}

To put your domain name in an unlocked state, use the same route with a PUT method, adding the transferLockStatus to unlocked:

Parameter Required Default Description
serviceName yes Domain name
transferLockStatus yes Desired state

Actions on theses routes are not instantaneous, which is why when re-executing a GET /domain/{serviceName}, you may see a transferLockStatus in unlocking or locking state.

Authcode

After unlocking your domain, you need an authcode to ensure that you own it, in order to transfer out. You will have to provide this code to your new registrar.

The following route allows you to retrieve it:

Parameter Required Default Description
serviceName yes Domain name

Your new registrar will then proceed with the transfer.

For .uk domain names, please refer to the dedicated documentation.

If the domain name has been suspended or expired, you will need to create a support ticket from your OVHcloud Control Panel.


Did you find this guide useful?

Please feel free to give any suggestions in order to improve this documentation.

Whether your feedback is about images, content, or structure, please share it, so that we can improve it together.

Your support requests will not be processed via this form. To do this, please use the "Create a ticket" form.

Thank you. Your feedback has been received.


These guides might also interest you...

OVHcloud Community

Access your community space. Ask questions, search for information, post content, and interact with other OVHcloud Community members.

Discuss with the OVHcloud community

In accordance with the 2006/112/CE Directive, modified on 01/01/2015, prices exclude VAT. VAT may vary according to the customer's country of residence.