Skip to main content

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-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-<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-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-<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-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.