Wiki

Transfer domain

Description

Start new domain name transfer.

Note: This function is not available for sub users.


 Parameters

Name Data Type Status Description
auth-id Integer Required Authentication parameter
auth-password String Required Authentication parameter
domain-name String Required Name of the domain
tld String Required The TLD the domain name will be registered with (com, net, org, etc)
mail String Required Email address
name String Required First and last name of the person
company String Required Name of the company
address String Required  Address of the company/person(street, number, etc)
city String Required  Example: Dallas
state String Required Example: Texas
zip Integer Required ZIP code
country String Required

2 letters country code according to ISO 3166

For .de domain names it must be DE

For .uk domain names it must be one of the following: GB (United Kingdom), IM (Isle of Man), JE (Jersey) or GG (Guernsey).

telnocc Integer Required Phone number calling code. Between 1 and 3 digits.
telno Integer Required Phone number
faxnocc Integer Optional Fax number calling code. Between 1 and 3 digits.
faxno Integer Optional Fax number.
transfer-code Integer Optional Transfer (Auth) code of the domain from its current registrar, if the TLD needs such.
registrant_type String Optional

Mandatory field for .fr/.re/.pm/.tf/.wf/.yt domain names. Possible values:

  • INDIVIDUAL - additional fields need to be added for this type
  • COMPANY - company name is a mandatory field when the registrant type is COMPANY
  • TRADEMARK - company name and an additional field for the trademark name need to be added for this type
  • ASSOCIATION - company (associacion) name and additional field for the waldec should be added
  • OTHER - company (organization) name and additional field for the registrant type should be added

Required for .ru domain names. Possible values:

  • ORG
  • PRS

Required for .ca domain names. Possible values:

  • CCO - Corporation (Canada or Canadian province or territory)
  • CCT - Canadian citizen
  • RES - Permanent Resident of Canada
  • GOV - Government or government entity in Canada
  • EDU - Canadian Educational institution
  • ASS - Canadian Unincorporated Association
  • HOP - Canadian Hospital
  • PRT - Partnership Registered in Canada
  • TDM - Trade-mark registered in Canada (by a non-Canadian owner)
  • TRD - Canadian Trade union
  • PLT - Canadian Political party
  • LAM - Canadian Library, Archive or Museum
  • TRS - Trust established in Canada
  • ABO - Aboriginal Peoples (individuals or groups) indigenous to Canada
  • INB - Indian Band recognized by the Indian Act of Canada
  • LGR - Legal Representative of a Canadian Citizen or Permanent Resident
  • OMK - Official mark registered in Canada
  • MAJ - Her Majesty the Queen

Required for .com.au and .net.au domain names. Possible values:

  • ACN - Australian Company Number
  • ABN - Australian Business Number
  • VIC_BN - Victoria Business Number
  • NSW_BN - New South Wales Business Number
  • SA_BN - South Australia Business Number
  • NT_BN - Northern Territory Business Number
  • WA_BN - Western Australia Business Number
  • TAS_BN - Tasmania Business Number
  • ACT_BN - Australian Capital Territory Business Number
  • QLD_BN - Queensland Business Number
  • TM - Trademark number
  • ARBN - Registrant's Australian Registered Body Number
  • Other

Required for .es domain names. Possible values:

  • 1 - Natural person or individual
  • 39 - Economic Interest Grouping
  • 47 - Association
  • 59 - Sports Association
  • 68 - Trade Association
  • 124 - Savings Bank
  • 150 - Community Property
  • 152 - Condominium
  • 164 - Religious Order or Institution
  • 181 - Consulate
  • 197 - Public Law Association
  • 203 - Embassy
  • 229 - Municipality
  • 269 - Sports Federation
  • 286- Foundation
  • 365 - Mutual Insurance Company
  • 434 - Provincial Government Body
  • 436 - National Government Body
  • 439 - Political Party
  • 476 - Trade Union
  • 510 - Farm Partnership
  • 524 - Public Limited Company / Corporation
  • 525 - Sports Public Limited Company
  • 554 - Partnership
  • 560 - General Partnership
  • 562 - Limited Partnership
  • 566 - Cooperative
  • 608 - Worker-owned Company
  • 612 - Limited Liability Company
  • 713 - Spanish (company) Branch
  • 717 - Temporary Consortium / Joint Venture
  • 744 - Worker-owned Limited Company
  • 745 - Provincial Government Entity
  • 746 - National Government Entity
  • 747 - Local Government Entity
  • 877 - Others
  • 878 - Designation of Origin Regulatory Council
  • 879 - Natural Area Management Entity

 

Required for .it domain names. Possible values:

  • 1 -  Italian and foreign natural persons
  • 2 - Companies/one man companies
  • 3 - Freelance workers/professionals
  • 4 - Non-profit organizations
  • 5 - Public organizations
  • 6 - Other subjects
  • 7 - Foreigners who match 2-6  

 

birth_date String Optional

Birth date. Mandatory field for .fr/.re/.pm/.tf/.wf/.yt domain names when the registrant_type is INDIVIDUAL. Format: YYYY-MM-DD

Optional field for .ru domain names when registrant_type is PRS. Format DD.MM.YYYY

birth_cc String Optional

Birth country code. Mandatory field for .fr/.re/.pm/.tf/.wf/.yt domain names when the registrant_type is INDIVIDUAL. Format: US

birth_city String Optional

Birth city name. Mandatory field for .fr/.re/.pm/.tf/.wf/.yt domain names when the registrant_type is INDIVIDUAL.

birth_zip String Optional

Postal code of the birth city. Mandatory field for .fr/.re/.pm/.tf/.wf/.yt domain names when the registrant_type is INDIVIDUAL.

publication String Optional

Restricted or Non-Restricted publication of the individual details. Mandatory field for .fr/.re/.pm/.tf/.wf/.yt domain names when the registrant_type is INDIVIDUAL. Possible values:

  • 0 - Non-Restricted
  • 1 - Restricted
vat String Optional

EU VAT number. Optional field for .fr/.re/.pm/.tf/.wf/.yt domain names when the registrant_type is COMPANY, TRADEMARK or ASSOCIATION.

siren String Optional

Siren number of the company (organization). Optional field for .fr/.re/.pm/.tf/.wf/.yt domain names when the registrant_type is COMPANY, TRADEMARK or ASSOCIATION.

duns String Optional

DUNS number of the company (organization). Optional field for .fr/.re/.pm/.tf/.wf/.yt domain names when the registrant_type is COMPANY, TRADEMARK or ASSOCIATION.

trademark String Optional

Name of the trademark. Mandatory field for .fr/.re/.pm/.tf/.wf/.yt domain names when the registrant_type is TRADEMARK.

Required field for .com.au and .net.au domain names when the registrant_type is TM. The parameter should be "Trademark Owner" or "Pending TM Owner".

       
waldec String Optional

Waldec number of the association. Mandatory field for .fr/.re/.pm/.tf/.wf/.yt domain names when the registrant_type is ASSOCIATION.

registrant_type_other String Optional Type of the organization. Mandatory field for .fr/.re/.pm/.tf/.wf/.yt domain names when the registrant_type is OTHER.
 privacy_protection Integer Optional Enabling/disabling Privacy Protection for the domain. 0=disabled and 1=enabled. By default the Privacy Protection is disabled. 
 code  Integer Optional

 Optional field for .ru domain names. This value is the Taxpayer Identification Number (TIN). This is a 10 digit number and is mandatory for Organization Contact Type, when the Country is Russia.

Required filed for .es domain names. Depending upon which registrant_type_id you provided, mention that ID's number as a value.

registrant_type_id   String Optional

Optional field for specific TLDs.

Required for .com.au and .net.au domain names. Should contain the ID of the number choosen registrant type in the registrant_type parameter.

Required field for .es domain names. Possible values:

  • 1 - DNI or NIF - Provide either the Spanish National Personal ID or company VAT ID number.
  • 3 - NIE - Provide the Spanish resident alien ID number
  • 0 - Other ID - If you do not have any of the above mentioned IDs, provide either your Passport number, any Foreign ID document number, Company Registration number, Driver's License number, etc.

Required field for .es domain names. Possible values:

  • 1 - DNI or NIF - Provide either the Spanish National Personal ID or company VAT ID number.
  • 3 - NIE - Provide the Spanish resident alien ID number
  • 0 - Other ID - If you do not have any of the above mentioned IDs, provide either your Passport number, any Foreign ID document number, Company Registration number, Driver's License number, etc.
publicity  Integer  Optional

Available for .it domain names.  (Consent to the processing of personal data for registration) Possible field values: 1=yes, 0=NO. If NO is used the request will fail.

ns Array Optional

Requred for .be domain names.

kpp Integer Optional

Available for .ru domain names. his value is the Territory-linked Taxpayer number. This is a 9 digit number and is mandatory for the Organization Contact Type, when the Country is Russia.

passport_number  String Optional  Available for .ru domain names. Document Number 
 passport_issued_by String  Optional  Available for .ru domain names. Document issued by (123 police station of Moscow) 
 passport_issued_on String   Optional   Available for .ru domain names. Passport issued date. Format: DD.MM.YYYY 

Return: Array with status and status description.


 Example

URL JSON: https://api.cloudns.net/domains/order-transfer-domain.json
POST/GET: auth-id=0&auth-password=password&domain-name=domain&tld=com&mail=user@gmail.com&name=John Doe&company=Unknown International LTD.&address=125 North Avenue&city=Dallas&state=Texas&zip=5000&country=US&telno=555555&telnocc=555&transfer-code=qWeRtY

URL XML: https://api.cloudns.net/domains/order-transfer-domain.xml
POST/GET: auth-id=0&auth-password=password&domain-name=domain&tld=com&mail=user@gmail.com&name=John Doe&company=Unknown International LTD.&address=125 North Avenue&city=Dallas&state=Texas&zip=5000&country=US&telno=555555&telnocc=555&transfer-code=qWeRtY

 

Cookies help us deliver our services. By using our services, you agree to our use of cookies. Learn more