Transfer a domain

This endpoint allows you to transfer a domain name Note :

The authinfo data can be mandatory for some extensions and not for others.

Endpoint

POST /registrar/v1/domains/transfer

Parameters

The function takes only one parameter : an array containing the following fields : These fields are the same than ones required for the ‘CreateDomain’ function.

Name	Location	Required	Type	Default value	Description
domain	Body	Yes	String		The domain name
commandDate	Body	No	String		If you want to delay the command, you can send a date with format Y-m-d
period	Body	No	String		Number of years you want to register your domain. Possible values: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]
owner	Body	No	String		Owner contact handle. Exemple : NSINT-56423 or PL_NS
admin	Body	No	String		Admin contact handle. Exemple : NSINT-56423 or PL_NS
tech	Body	No	String		Tech contact handle. Exemple : NSINT-56423 or PL_NS
primary_hidden_nameserver	Body	No	String		If you want to use a primary hidden nameserver, you can use this field. If you do not have the right, please contact your account manager.
nameservers	Body	No	array[string]		An array containing the list of DNS used for this domain. The primary DNS will use array key number 0, secondary one will use key ‘1’, etc...
authInfo	Body	No	String		The domain authinfo.It can be mandatory for some extensions and not for others.
language	Body	No	String		The domain language,use the ISO 639-1 code
tmNoticeXml	Body	No	String		The trademark notice of the domain, required with tmNoticeDate
tmNoticeDate	Body	No	String		The trademark date of the domain, required with tmNoticeXml
addons	Body	No	Addons		This field is needed when registering some particular extensions. Check the addons Schema for more details

Response

Transfer domain

Example Request

POST /registrar/v1/domains/transfer
Content-Type: application/json

Body

{
  "domain": "example.com",
  "commandDate": "2024-02-15",
  "period": "1",
  "owner": "NSINT-56423 or PL_NS",
  "admin": "NSINT-56423 or PL_NS",
  "tech": "NSINT-56423 or PL_NS",
  "primary_hidden_nameserver": "ns1.hidden.com",
  "nameservers": {
    "0": "ns1.test.com"
  },
  "authInfo": "NMS-123",
  "language": "fr",
  "tmNoticeXml": "<?xml version="1.0" encoding="UTF-8"?>
                <tmNotice:notice xmlns:tmNotice="urn:ietf:params:xml:ns:tmNotice-1.0">
                <tmNotice:id>0355726770000000000008914683</tmNotice:id>
                <tmNotice:notBefore>2014-02-04T00:00:00.0Z</tmNotice:notBefore>
                <tmNotice:notAfter>2014-02-06T00:00:00.0Z</tmNotice:notAfter>
                <tmNotice:label>organisme</tmNotice:label>
                <tmNotice:claim>
                <tmNotice:markName>Organisme</tmNotice:markName>
                <tmNotice:holder entitlement="owner">
                <tmNotice:org>ORGANISME SA</tmNotice:org>
                <tmNotice:addr>
                <tmNotice:street>1, route des Jeunes, case postale 239</tmNotice:street> 
                <tmNotice:city>ANGERS</tmNotice:city>
                <tmNotice:pc>49000</tmNotice:pc>
                <tmNotice:cc>49000</tmNotice:cc>
                </tmNotice:addr>
                </tmNotice:holder>
                <tmNotice:contact type="agent">
                <tmNotice:name>John Doe</tmNotice:name>
                <tmNotice:org>NAMESHIELD</tmNotice:org>
                <tmNotice:addr>
                <tmNotice:street>79 rue desjardins</tmNotice:street>
                <tmNotice:city>ANGERS</tmNotice:city>
                <tmNotice:pc>49100</tmNotice:pc>                                                                                               
                <tmNotice:cc>FR</tmNotice:cc>
                </tmNotice:addr>
                <tmNotice:voice>+33.241187828</tmNotice:voice>
                <tmNotice:fax>+33.741182829</tmNotice:fax>                                                                                                                                <tmNotice:email>tmch@nameshield.net</tmNotice:email>
                </tmNotice:contact>
                <tmNotice:jurDesc jurCC="WO">World Intellectual Property Organization (WIPO) (International Bureau of)</tmNotice:jurDesc>
                <tmNotice:classDesc classNum="1">Chemicals used in industry, science and photography, as well as in agriculture, horticulture and forestry; unprocessed artificial resins, unprocessed plastics; manures; fire extinguishing compositions; tempering and soldering preparations; chemical substances for preserving foodstuffs; tanning substances; adhesives used in industry. </tmNotice:classDesc>
                <tmNotice:classDesc classNum="3">Bleaching preparations and other substances for laundry use; cleaning, polishing, scouring and abrasive preparations; soaps; perfumery, essential oils, cosmetics, hair lotions; dentifrices. </tmNotice:classDesc>
                <tmNotice:classDesc classNum="30">Coffee, tea, cocoa and artificial coffee; rice; tapioca and sago; flour and preparations made from cereals; bread, pastry and confectionery;ices; sugar, honey, treacle; yeast, baking-powder; salt; mustard; vinegar, sauces (condiments); spices; ice. </tmNotice:classDesc>
                <tmNotice:goodsAndServices> Chemical products for use in the perfume and fragrance industry. Natural and artificial perfumes; cosmetic products; soaps; essential oils. Natural and artificial food flavouring agents in solid or liquid form.</tmNotice:goodsAndServices>
                </tmNotice:claim>
                </tmNotice:notice>",
  "tmNoticeDate": "2022-04-21 13:06:24",
  "addons": {
    "trademarkNum": "TDN123"
  }
}

Example Response

{
    "message": "Domain name in pending transfer."
}