Contacts Create a contact Introduction create < tld >-order Valid values for < tld >: com net org info biz mobi name us de cn eu With this request you can create person contacts. You can create 1 contact with one request. ATTENTION: You will find the request-field "individual" within the request-definition. if you set it to "Y", you have to provide the request-fields "lname" and "fname" or "name". If you set it to "N", you have to provide information in the request-field "organization". As the whois for .com shows a field called person, the rules for generating this field are the following: If you provide the field "name", the whois is showing always the values of this field, regardless of "fname" and "lname". If you only provide the field "fname" and the field "lname", we will generate the field "name" as the result of the concatenation of "fname" + " " + "lname". The result of "create com-contact" is a reference which is following the format: CCOM- e.g. CCOM-176269 for a .com domain. CNET- e.g. CNET-176269 for a .net domain. CORG- e.g. CORG-176269 for a .org domain. C-LRMS e.g. C176269-LRMS for a .info domain. CNEU- e.g. CNEU-176269 for a .biz domain. COMO- e.g. COMO-176269 for a .mobi domain. CNAM- e.g. CNAM-176269 for a .name domain. COUS- e.g. COUS-176269 for a .us domain. CODE- e.g. CODE-176269 for a .de domain. COCN- e.g. COCN-176269 for a .cn domain. C e.g. C176269 for a .eu domain. Request fields mailsubject: create < tld >-contact [your reference id] Definition of this request ATTENTION According to the rules of DENIC, you have to provide a faxnumber for the admin-c and the tech-c of a .de domain. request-field valid values required com|net|org|info|mobi|name|us|de biz|cn|eu individual [YN] yes lname [\x20-\x7e]{0,80} [\x20-\x7e]{0,30} yes, if individual = Y fname [\x20-\x7e]{0,80} [\x20-\x7e]{0,30} yes, if individual = Y name [\x20-\x7e]{0,80} [\x20-\x7e]{0,30} yes, if fname and/or lname are not given title [\x20-\x7e]{0,80} [\x20-\x7e]{0,30} no organization [\x20-\x7e]{0,80} [\x20-\x7e]{0,30} yes, if individual = N address-1 [\x20-\x7e]{1,80} [\x20-\x7e]{1,30} yes address-2 [\x20-\x7e]{0,80} [\x20-\x7e]{0,30} no address-3 Only for biz/cn/eu [\x20-\x7e]{0,30} no postal-code [\x20-\x7e]{1,50} [\x20-\x7e]{1,10} yes city [\x20-\x7e]{1,80} [\x20-\x7e]{1,30} yes state [\x20-\x7e]{0,80} [\x20-\x7e]{0,30} no country @country yes email @email yes phone [\x20-\x7e]{1,50} [[\x20-\x7e]{1,17} yes fax [[\x20-\x7e]{0,50} [[\x20-\x7e]{0,17} yes (for admin-c and tech-c of .de only) CREATE COM CONTACT Example 1: create com-contact (name will be generated from fname and lname) subject: create com-contact [your reference id] email:gonzo@nose.net individual:Y fname:gonzo lname:nose address-1:horsefair mews address-2:App. 1 postal-code:4711 city:romsey country:DE phone:44 13383794 504040 Example 2: create com-contact (fname and lname will be ignored) subject: create com-contact [your reference id] email:gonzo@nose.net individual:Y fname:gonzo lname:nose name:Mr. Gonzo Nose address-1:horsefair mews address-2:App. 1 postal-code:4711 city:romsey country:DE phone:44 13383794 504040 CREATE NET CONTACT Example 1: create net-contact (name will be generated from fname and lname) subject: create net-contact [your reference id] email:gonzo@nose.net individual:Y fname:gonzo lname:nose address-1:horsefair mews address-2:App. 1 postal-code:4711 city:romsey country:DE phone:44 13383794 504040 Example 2: create net-contact (fname and lname will be ignored) subject: create net-contact [your reference id] email:gonzo@nose.net individual:Y fname:gonzo lname:nose name:Mr. Gonzo Nose address-1:horsefair mews address-2:App. 1 postal-code:4711 city:romsey country:DE phone:44 13383794 504040 CREATE ORG CONTACT Example 1: create org-contact (name will be generated from fname and lname) subject: create org-contact [your reference id] email:gonzo@nose.org individual:Y fname:gonzo lname:nose address-1:horsefair mews address-2:App. 1 postal-code:4711 city:romsey country:DE phone:44 13383794 504040 Example 2: create org-contact (fname and lname will be ignored) subject: create org-contact [your reference id] email:gonzo@nose.org individual:Y fname:gonzo lname:nose name:Mr. Gonzo Nose address-1:horsefair mews address-2:App. 1 postal-code:4711 city:romsey country:DE phone:44 13383794 504040 CREATE INFO CONTACT Example 1: create info-contact (name will be generated from fname and lname) subject: create info-contact [your reference id] email:gonzo@nose.info individual:Y fname:gonzo lname:nose address-1:horsefair mews address-2:App. 1 postal-code:4711 city:romsey country:DE phone:44 13383794 504040 Example 2: create info-contact (fname and lname will be ignored) subject: create info-contact [your reference id] email:gonzo@nose.info individual:Y fname:gonzo lname:nose name:Mr. Gonzo Nose address-1:horsefair mews address-2:App. 1 postal-code:4711 city:romsey country:DE phone:44 13383794 504040 CREATE BIZ CONTACT Example 1: create biz-contact (name will be generated from fname and lname) subject: create biz-contact [your reference id] email:gonzo@nose.biz individual:Y fname:gonzo lname:nose address-1:horsefair mews address-2:App. 1 postal-code:4711 city:romsey country:DE phone:44 13383794 504040 Example 2: create biz-contact (fname and lname will be ignored) subject: create biz-contact [your reference id] email:gonzo@nose.biz individual:Y fname:gonzo lname:nose name:Mr. Gonzo Nose address-1:horsefair mews address-2:App. 1 postal-code:4711 city:romsey country:DE phone:44 13383794 504040 CREATE NAME CONTACT Example 1: create name-contact (name will be generated from fname and lname) subject: create name-contact [your reference id] email:gonzo@nose.net individual:Y fname:gonzo lname:nose address-1:horsefair mews address-2:App. 1 postal-code:4711 city:romsey country:DE phone:44 13383794 504040 Example 2: create name-contact (fname and lname will be ignored) subject: create name-contact [your reference id] email:gonzo@nose.net individual:Y fname:gonzo lname:nose name:Mr. Gonzo Nose address-1:horsefair mews address-2:App. 1 postal-code:4711 city:romsey country:DE phone:44 13383794 504040 CREATE US CONTACT Example 1: create us-contact (name will be generated from fname and lname) subject: create us-contact [your reference id] email:gonzo@nose.net individual:Y fname:gonzo lname:nose address-1:horsefair mews address-2:App. 1 postal-code:4711 city:romsey country:DE phone:44 13383794 504040 Example 2: create us-contact (fname and lname will be ignored) subject: create us-contact [your reference id] email:gonzo@nose.net individual:Y fname:gonzo lname:nose name:Mr. Gonzo Nose address-1:horsefair mews address-2:App. 1 postal-code:4711 city:romsey country:DE phone:44 13383794 504040 CREATE DE CONTACT Example 1: create de-contact (name will be generated from fname and lname) subject: create de-contact [your reference id] email:gonzo@nose.net individual:Y fname:gonzo lname:nose address-1:Musterstrasse 19 address-2:App. 1 postal-code:4711 city:Musterstadt country:DE phone:49 13383794 504040 Example 2: create net-contact (fname and lname will be ignored) subject: create net-contact [your reference id] email:gonzo@nose.net individual:Y fname:gonzo lname:nose name:Mr. Gonzo Nose address-1:Musterstrasse 19 address-2:App. 1 postal-code:4711 city:Musterstadt country:DE phone:49 13383794 504040 CREATE CN CONTACT Example 1: create cn-contact (name will be generated from fname and lname) subject: create cn-contact [your reference id] email:gonzo@nose.net individual:Y fname:gonzo lname:nose address-1:horsefair mews address-2:App. 1 postal-code:4711 city:romsey country:DE phone:44 13383794 504040 Example 2: create cn-contact (fname and lname will be ignored) subject: create cn-contact [your reference id] email:gonzo@nose.net individual:Y fname:gonzo lname:nose name:Mr. Gonzo Nose address-1:horsefair mews address-2:App. 1 postal-code:4711 city:romsey country:DE phone:44 13383794 504040 CREATE EU CONTACT Example 1: create eu-contact (name will be generated from fname and lname) subject: create eu-contact [your reference id] email:gonzo@nose.net individual:Y fname:gonzo lname:nose address-1:horsefair mews address-2:App. 1 postal-code:4711 city:romsey country:DE phone:44 13383794 504040 Example 2: create eu-contact (fname and lname will be ignored) subject: create eu-contact [your reference id] email:gonzo@nose.net individual:Y fname:gonzo lname:nose name:Mr. Gonzo Nose address-1:horsefair mews address-2:App. 1 postal-code:4711 city:romsey country:DE phone:44 13383794 504040 Modify a contact Introduction With this request you can modify person contacts. You can modify 1 contact with one request. Unspecified request-fields will be ignored. ATTENTION: After changing the content of the specified contact, the whois information is automatically updated. Keep in mind that you have to provide the numerical suffix of a handle. If you want to make an address change within the owner-record of a domain, you have to send a "modify com-domain"-request after changing the content of the specified handle. Only contact-handles, which are created by the reseller or where the e-mail within the contact is matching the reseller's robot-email can be changed. Definition of this request request-field valid values required com|net|org|info|mobi|name|us|de biz|cn|eu handle Please, refer to the table below. yes individual [YN] yes lname [\x20-\x7e]{0,80} [\x20-\x7e]{0,30} no, if name is given fname [\x20-\x7e]{0,80} [\x20-\x7e]{0,30} no, if name is given name [\x20-\x7e]{0,80} [\x20-\x7e]{0,30} yes, if fname and/or lname are not given title [\x20-\x7e]{0,80} [\x20-\x7e]{0,30} no organization [\x20-\x7e]{0,80} [\x20-\x7e]{0,30} yes, if individual = N address-1 [\x20-\x7e]{1,80} [\x20-\x7e]{1,30} yes address-2 [\x20-\x7e]{0,80} [\x20-\x7e]{0,30} no address-3 Only for biz/cn/eu [\x20-\x7e]{0,30} no postal-code [\x20-\x7e]{1,50} [\x20-\x7e]{1,10} yes city [\x20-\x7e]{1,80} [\x20-\x7e]{1,30} yes state [\x20-\x7e]{0,80} [\x20-\x7e]{0,30} no country @country yes email @email yes phone [\x20-\x7e]{1,50} [[\x20-\x7e]{1,17} yes fax [[\x20-\x7e]{0,50} [[\x20-\x7e]{0,17} yes (for admin-c and tech-c of .de only) TLD handle com CCOM- net CNET- org CORG- info C-LRMS biz CNEU- mobi COMO- name CNAM- us COUS- de CODE- cn COCN- eu C MODIFY COM CONTACT Example 1: modify com-contact subject: modify com-contact [your reference id] handle:CCOM-1235 address-1:horsefair mews postal-code:4711 city:romsey country:DE phone:44 13383794 504040   MODIFY NET CONTACT Example 1: modify net-contact subject: modify net-contact [your reference id] handle:CNET-1235 address-1:horsefair mews postal-code:4711 city:romsey country:DE phone:44 13383794 504040   MODIFY ORG CONTACT Example 1: modify org-contact subject: modify org-contact [your reference id] handle:CORG-1235 address-1:horsefair mews postal-code:4711 city:romsey country:DE phone:44 13383794 504040   MODIFY INFO CONTACT Example 1: modify info-contact subject: modify info-contact [your reference id] handle:C293829-LRMS address-1:horsefair mews postal-code:4711 city:romsey country:DE phone:44 13383794 504040   Example 2: modify info-contact (new naming convention for info-handles) subject: modify info-contact [your reference id] handle:CAFI-007 address-1:horsefair mews postal-code:4711 city:romsey country:DE phone:44 13383794 504040   MODIFY BIZ CONTACT Example 1: modify biz-contact subject: modify biz-contact [your reference id] handle:CNEU-12345 address-1:horsefair mews postal-code:4711 city:romsey country:DE phone:44 13383794 504040   MODIFY NAME CONTACT Example 1: modify name-contact subject: modify name-contact [your reference id] handle:CNAM-1235 address-1:horsefair mews postal-code:4711 city:romsey country:DE phone:44 13383794 504040   MODIFY US CONTACT Example 1: modify us-contact subject: modify us-contact [your reference id] handle:COUS-1235 address-1:horsefair mews postal-code:4711 city:romsey country:DE phone:44 13383794 504040   MODIFY DE CONTACT Example 1: modify de-contact subject: modify de-contact [your reference id] handle:CODE-1235 address-1:Musterstrasse 1 postal-code:47011 city:Musterstadt country:DE phone:44 13383794 504040   MODIFY EU CONTACT Example 1: modify eu-contact subject: modify eu-contact [your reference id] handle:C12345 address-1:horsefair mews postal-code:4711 city:romsey country:DE phone:44 13383794 504040 Change an address Introduction change < tld >-address Valid values for < tld >: com net org info biz mobi name us de cn With this request you can change the address of the domain owner. ATTENTION: It is not possible to change the following fields of the owner-record: individual lname fname title organization email Request fields mailsubject: change com-address [your reference id] Definition of this request request-field valid values required com|net|org|info|mobi|name|us|de biz|cn domains0 [a-z0-9-]{1,63}\.< tld > yes address-1 [\x20-\x7e]{1,80} [\x20-\x7e]{1,30} no address-2 [\x20-\x7e]{0,80} [\x20-\x7e]{0,30} no address-3 [\x20-\x7e]{0,80} [\x20-\x7e]{0,30} no postal-code [\x20-\x7e]{1,50} [\x20-\x7e]{0,30} no city [\x20-\x7e]{1,80} [\x20-\x7e]{1,30} no state [\x20-\x7e]{0,80} [\x20-\x7e]{0,30} no country @country no phone [[\x20-\x7e]{1,50} [[\x20-\x7e]{1,17} no fax [[\x20-\x7e]{0,50} [[\x20-\x7e]{0,17} no CHANGE .COM ADDRESS Example 1: change com-address subject: change com-address [your reference id] domains0:gonzo.com address-1:horsefair mews postal-code:4711 city:romsey country:DE phone:44 13383794 504040 CHANGE .NET ADDRESS Example 1: change net-address subject: change net-address [your reference id] domains0:gonzo.net address-1:horsefair mews postal-code:4711 city:romsey country:DE phone:44 13383794 504040 CHANGE .ORG ADDRESS Example 1: change org-address subject: change org-address [your reference id] domains0:gonzo.org address-1:horsefair mews postal-code:4711 city:romsey country:DE phone:44 13383794 504040 CHANGE .INFO ADDRESS Example 1: change info-address subject: change info-address [your reference id] domains0:gonzo.info address-1:horsefair mews postal-code:4711 city:romsey country:DE phone:44 13383794 504040 CHANGE .BIZ ADDRESS Example 1: change biz-address subject: change biz-address [your reference id] domains0:gonzo.biz address-1:horsefair mews postal-code:4711 city:romsey country:DE phone:44 13383794 504040 CHANGE .NAME ADDRESS Example 1: change name-address subject: change name-address [your reference id] domains0:gonzo.name address-1:horsefair mews postal-code:4711 city:romsey country:DE phone:44 13383794 504040 CHANGE .US ADDRESS Example 1: change us-address subject: change us-address [your reference id] domains0:gonzo.us address-1:horsefair mews postal-code:4711 city:romsey country:DE phone:44 13383794 504040 CHANGE .DE ADDRESS Example 1: change de-address subject: change de-address [your reference id] domains0:gonzo.de address-1:horsefair mews postal-code:4711 city:romsey country:DE phone:44 13383794 504040 CHANGE .CN ADDRESS Example 1: change cn-address subject: change cn-address [your reference id] domains0:gonzo.cn address-1:horsefair mews postal-code:4711 city:romsey country:DE phone:44 13383794 504040 Change an owner Introduction With this request you can change the owner of a .com/.net/.org/.info./.mobi/.name/.biz/.de/.cn/.eu./us-domain. Request fields mailsubject: change owner [your reference id] Definition of this request request-field valid values required domains0 [a-z0-9-]{1,63}\.(com|net|org|info|mobi|biz|de|cn|eu|us) yes email an email without the numerical suffix no individual [YN] no name (.com,.net,.org,.info,.biz,.mobi,.de,.cn,.eu,.us only) [\x20-\x7e]{0,80} no lname [\x20-\x7e]{0,80} no fname [\x20-\x7e]{0,80} no title [\x20-\x7e]{0,80} no organization [\x20-\x7e]{0,80} no address-1 [\x20-\x7e]{0,80} no address-2 [\x20-\x7e]{0,80} no postal-code [\x20-\x7e]{0,50} no state [\x20-\x7e]{0,80} no city [\x20-\x7e]{0,80} no country @country no phone [\x20-\x7e]{0,50} no fax lock-opt-out [\x20-\x7e]{0,50} [YN] no no CHANGE .COM OWNER Example 1: change owner subject: change owner [your reference id] domains0:gonzo.com fname:hans lname:nose address-1:horsefair mews postal-code:4711 city:romsey country:DE phone:44 13383794 504040 CHANGE .NET OWNER Example 1: change owner subject: change owner [your reference id] domains0:gonzo.net fname:hans lname:nose address-1:horsefair mews postal-code:4711 city:romsey country:DE phone:44 13383794 504040 CHANGE .ORG OWNER Example 1: change owner subject: change owner [your reference id] domains0:gonzo.org fname:hans lname:nose address-1:horsefair mews postal-code:4711 city:romsey country:DE phone:44 13383794 504040 CHANGE .INFO OWNER Example 1: change owner subject: change owner [your reference id] domains0:gonzo.info fname:hans lname:nose address-1:horsefair mews postal-code:4711 city:romsey country:DE phone:44 13383794 504040 CHANGE .BIZ OWNER Example 1: change owner subject: change owner [your reference id] domains0:gonzo.biz fname:hans lname:nose address-1:horsefair mews postal-code:4711 city:romsey country:DE phone:44 13383794 504040 CHANGE .NAME OWNER Example 1: change owner subject: change owner [your reference id] domains0:gonzo.name fname:hans lname:nose address-1:horsefair mews postal-code:4711 city:romsey country:DE phone:44 13383794 504040 CHANGE .US OWNER Example 1: change owner subject: change owner [your reference id] domains0:gonzo.us fname:hans lname:nose address-1:horsefair mews postal-code:4711 city:romsey country:DE phone:44 13383794 504040 CHANGE .DE OWNER Example 1: change owner subject: change owner [your reference id] domains0:gonzo.de fname:hans lname:nose address-1:horsefair mews postal-code:4711 city:romsey country:DE phone:44 13383794 504040 CHANGE .CN OWNER Example 1: change owner subject: change owner [your reference id] domains0:gonzo.cn fname:hans lname:nose address-1:horsefair mews postal-code:4711 city:romsey country:DE phone:44 13383794 504040 .asia Contacts new-handle (implicit creation of a new contact) This means the definition of a new contact. if a contact with the provided email address exists in the JOKER-DATABASE, a new contact will be created. The reference for the created handle is following the format COAS-, e.g. COAS-176269. ATTENTION: The name of the request field depends on the context. If you want to create a contact for the owner-contact, you have to replace the ".." at the beginning of the fieldname with "owner-contact". If you want to create a contact for the admin-contact, you have to replace the ".." at the beginning of the fieldname with "admin-contact". If you want to create a contact for the tech-contact, you have to replace the ".." at the beginning of the fieldname with "tech-contact". If you want to create a contact for the billing-contact, you have to replace the ".." at the beginning of the fieldname with "billing-contact". There is a new request field called name within the contact definition. This field is mandatory, if you do not provide the fname lname . You have to provide the request field name , if fname and lname are not found. This is very important for the whois output. Everytime a field person is shown. If you are using the request field name, the whois is showing the value for name , regardless the content of the request fields fname and lname . If you do not provide the request field name but your are providing the request fields fname and lname , the whois is showing the concatenation of these fields. There is also a new request field called address-3 within the contact definition. This field is not mandatory, it is simply the 3rd line of the address. request-field valid values required ".."-individual [YN] yes ".."-lname [\x20-\x7e]{0,80} no, if name is given ".."-fname [\x20-\x7e]{0,80} no, if name is given ".."-name [\x20-\x7e]{0,80} yes, if fname and/or lname are not given ".."-title [\x20-\x7e]{0,80} no ".."-organization [\x20-\x7e]{0,80} yes, if individual = N ".."-address-1 [\x20-\x7e]{1,80} yes ".."-address-2 [\x20-\x7e]{0,80} no ".."-address-3 [\x20-\x7e]{0,80} no ".."-postal-code [\x20-\x7e]{1,50} yes ".."-city [\x20-\x7e]{1,80} yes ".."-state [\x20-\x7e]{0,80} no ".."-country @country yes ".."-email @email yes ".."-phone [[\x20-\x7e]{1,50} yes ".."-fax [[\x20-\x7e]{0,50} no An existing contact ( @asiacont or @same-as ) (.asia only) This means an existing contact handle in the JOKER-DATABASE. Examples: owner-contact-handle:COAS-176269 admin-contact-handle:COAA-176229 tech-contact-handle:COAS-176269 billing-contact-handle:COAS-176269 ASIA-domains require an additional type of contact, the CED contact. This contact has to have its residence in the Asian/Australian area. The Joker.com Registry Gateways automatically will use your provided tech-contact for the CED contact.  This means that the request for you remains consistent with the usual requests, you only have to make sure that the country code is correct, otherwise the .asia registry will reject the order.  In case you have entered a non-existing contact handle, the system will send you an errormail. It is also possible to set a reference to a contact definition, which has been made earlier within the current request. To do so, please use the following syntax: admin-contact-handle:same-as-owner-contact tech-contact-handle:same-as-admin-contact billing-contact-handle:same-as-tech-contact The @same-as makro always replaces the value for the specified contact handle with the email address of the makrotarget. If the referenced contact has to be created with this request, it takes the result handle. Keep in mind that for .asia-requests the contact handles for (.com/.net/.org/.info/.biz/.de)-contacts are not allowed. If you are referencing to a shortcut like hans@nose.net#1, you will get an error.