# 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-<number> e.g. CCOM-176269 for a .com domain. - CNET-<number> e.g. CNET-176269 for a .net domain. - CORG-<number> e.g. CORG-176269 for a .org domain. - C<number>-LRMS e.g. C176269-LRMS for a .info domain. - CNEU-<number> e.g. CNEU-176269 for a .biz domain. - COMO-<number> e.g. COMO-176269 for a .mobi domain. - CNAM-<number> e.g. CNAM-176269 for a .name domain. - COUS-<number> e.g. COUS-176269 for a .us domain. - CODE-<number> e.g. CODE-176269 for a .de domain. - COCN-<number> e.g. COCN-176269 for a .cn domain. - C<number> 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-fieldvalid 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-fieldvalid 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)
TLDhandle
com CCOM-<number>
net CNET-<number>
org CORG-<number>
info C<number>-LRMS
biz CNEU-<number>
mobi COMO-<number>
name CNAM-<number>
us COUS-<number>
de CODE-<number>
cn COCN-<number>
eu C<number>
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-fieldvalid valuesrequired
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-fieldvalid valuesrequired
domains0\[a-z0-9-\]{1,63}\\.(com|net|org|info|mobi|biz|de|cn|eu|us)yes
emailan email **without** the numerical suffixno
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-<number>, 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 **fnamelname**. 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-fieldvalid valuesrequired
".."-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.