1. Website FAQ >> 1.1 Basics

I do not see my domain(s) after logging in!

Domains missing in your Dashboard

 

If you are missing a domain, this may be because you have not ordered this domain yourself, and you have not been assigned with the appropriate permissions ('grants') to list or modify this domain.

 

In this case, you may contact the owner of the domain to ask him for such assigments.

 

In case you yourself are the owner of this domain (you purchased it), or you believe a domain is missing by error, please contact the Joker.com Support.

Last update: 2015-05-19 11:22

1. Website FAQ >> 1.2 Login Account

How could I use the Joker.com system?

The Joker.com Registrar System

 
You have to register yourself at Joker.com to be able to use the system.
Registration is an easy step - we only need a login name and a valid email address from you.
A password will be sent to this email address.
 
If you have forgotten your password, please use the link "forgot password?" on the start page of Joker.com.
You will then receive a new password by email.

Last update: 2015-05-19 11:24

Why did I receive my Joker.com password?

Why did i receive my Joker.com password?

 

There are at least three possible scenarios: You can only receive your own password, nothing else!
 

Last update: 2015-05-19 11:25

How to change the password?

 

How to change my password?

 

Please login into our 'Servicezone -> myJoker' using your login name and your current password, and perform "Change Password".

Last update: 2015-05-19 11:29

How could I change my email address?

How to change my Email address?

 

If you are logged in, you can change your email address by visiting the 'Service zone' => 'My Joker '.

There you will find the "change email" form.

This procedure will send a verification link to the new email address. The old address remains active until this verfication link has been clicked.

 

Last update: 2015-05-19 11:30

1. Website FAQ >> 1.3 Domain Registration

What domains can be ordered?

Domain Registration

 
Joker.com currently offers most of the generic top level domains (gTLDs) - including the new top level domains (ngTLDs), and a lot of ccTLDs (country domains). Please find the complete list here.
 
Most top level domains are available for one (1) up to ten (10) years. 

 

At any time you may renew (prolong) your domain. Before your domain expires, you will be notified by email and asked to renew it. Please find details about this here:  How to renew a domain? and ERRP - Expired Registration Recovery Policy.
 
Resellers also are able to make use of automatic renewals (Auto Renewal) of selected or all domains.
 
To order domains, please click here.
 
 

Last update: 2015-05-18 11:52

What length is allowed for a domain name?

Length of a Domain Name

 

We support a maximum length of 67 characters (including suffix [com|net|org|info|biz]). A minimum of 2 (not including the TLD) is required by most registries.
The domain name can not start with a hyphen "-" , at com-net-org it can not start with "bq-" or have hyphens "--" at the third and fourth position.
 

Last update: 2015-05-19 11:37

Which .de domain names are allowed?

 

Which .de domain names are allowed?

 

A .de domain name could contain: numbers (0-9), hyphen (-) and letters (a-z). With the introduction of  IDN registrations, 92 additional characters are allowed from character set Latin Extended-A and Latin-1 Supplement.

Important rules:
Most restrictions regarding country- or motor vehicle abbreviations have been removed recently. Please find more information under DENIC-Domainrichtlinien.
 

Last update: 2015-05-19 11:35

I have made a typo. How can I cancel my domain name registration?

How can I cancel my domain name registration? 

 

We are sorry but this is not possible. Domains are registered in realtime. So please check your domain name carefully to avoid any further problems.
In case you made a typo you will have to start again.
Of course, it is always possible to delete a domain name - but this will not result in a refund.
 

Last update: 2015-05-19 11:41

Who gets the receipt of the domain order?

 

Domain order receipt

 

We do send receipts by email only:

 
The postal address of the receipt is the same as of the billing contact. We do not send invoices by regular mail, except for registered resellers. Resellers do get a monthly invoice for all sales of the last month by email and regular mail.
Please check here to find out more about 'roles' resp. 'billing role'.
 

Last update: 2015-05-19 11:43

I had a charge on my credit card, but I do not remember the domain.

Verify charge on your credit card

 

Please login into our Support/Contact section, using your login name and your password.
Then choose the topic "Billing" and send us

 

Last update: 2015-05-19 11:48

What domains do I own? I need a list.

 

List of your Domains

 

Your domain name is associated with your Joker.com login account, i.e. the account you registered them with.
Please login into our Servicezone using your login name and your password. Select "Domain Modification" and a list of your domains will be generated.
In case you miss a domain in this list, please check I can't see my domain(s) after logging in!.

Last update: 2015-05-19 11:52

How could I check if my order was successful?

Verify your Domain Order

 

If you want to check if your domain has been registered successfully, you may simply wait for the email notification. You can also check the domain by querying our 'Search whois', just enter the domain name in question.
 

Remember: www.my-domain.com is not the domain name, it is my-domain.com.

In case you do not find anything and you have initiated your order at least one workday before, please contact Support/Contact, choosing topic "Support", subject "Domain name not visible".
 
 

Last update: 2015-05-19 11:54

My last order failed (due to a credit card problem). What should I do?

My Order failed / credit card problem

 

If an order has been cancelled by any reason, then this request has FAILED. There is no option to 'reactivate' this order request,  you have to start a new order.

It then may happen that you will get an error  "The domain is already registered" - then the domain had already been temporarily reserved by your first request.

In this case please try again a few minutes later, to let the process settle at our side.

 

 

Last update: 2015-05-19 12:00

What is an 'Easy order'?

 

What is Easy Order?

 

Easy order is the fastest and most convenient method for customers to order a domain.
'Easy' means, that you only have to provide a minimum of information to order a domain. Of course, you still may modify all aspects of your domain afterwards.
 
This way, a domain is registered with whois contacts like 'owner', 'admin'm 'tech' etc. being all the same. In case you already do have some other domains with Joker.com, the system automatically provides you with a working contact.
 

The domains are registered using our free of charge namerservers (nameservers are changeable after registration).

 

Last update: 2015-05-19 12:03

What is an 'Advanced order'?

 

What is Advanced Order?

 

Advanced order allows customers to configure all details of the selected domains during the registration.

Different contact data can be entered for owner, admin, tech and billing, as well as custom nameservers (also changeable after registration).

 

Last update: 2015-05-19 12:04

What are 'contacts'?

Contacts

 

Associated with each domain, there is a so-called 'Whois record'. The information within this Whois record is published publicly, and has to be provided by you, the domain registrant.

This Whois record - the part which is provided by you - consists of the following contact information:

 

A contact is a kind of 'template', consisting of an email, name and street address. If you populate a domain with Whois data, you create such a contact (or choose an existing one), and assign this contact to a domain.

 

You are free to assign individual contacts to each domain, or use a single contact for more than one domain. In this case, it is important to know that in case you change such a contact afterwards, those changes will apply to all domains which have been assigned this contact.

 

Please note: These contacts are for published Whois records only. They do not define the usage of your domain, or the persons able to access a domain. To actually grant access rights to other persons than the purchaser of a domain, explicit 'roles ' may be granted using the Joker.com domain management in the service zone.

Important: You are obliged to enter only valid and true address and identity information for Whois data. This is a requirement of all domain registries.

 

Last update: 2015-05-19 12:07

How to grant roles (= grant permissions to others)?

Roles and Permissions

You always can invite additional individuals (beside you) to administrate your domain(s). For this, you can assign so-called "roles" to other people, which define what sort of access is granted.

Important: These "roles" solely allow to grant access to your domains within Joker.com, they do not have any impact on what is shown in Whois as published contacts.

To invite somebody to get access to your domains, a special link is sent to the email address you provide. If the invitee does not already have a Joker.com login, he will get a chance to register when he clicks the link in his email.
Enter a "Description" to name the individual grant, to be able to identify your grants later.
You always may issue grants or revoke existing grants in our "service zone ".

In case you are a Joker.com Reseller, you may also use the standard domain permission administration (service zone -> modify domain). In this case, you have the choice of assigning permissions or whole domains to other users using an invitation similar to the procedure above, or doing a direct assignment which will be applied immediately.

Available roles:

Resellers additionally may use service zone -> modify domain:


Last update: 2013-08-29 15:38

Whois Privacy Services

Secure your Domain Privacy

 

All major registries, as well as Joker.com and EIS AG, require by their policies and Terms&Conditions, that registrants provide accurate, complete and current personal data, that is made publicly available on the internet by the WHOIS service.

 

This WHOIS service is available to everyone, and usually includes the name, street address and email addresses of the registrant. The use of incorrect, incomplete or fake data is a violation of the registration agreement of the related registry and EIS AG, and may lead to the deletion of the related domain name (please also see 5.c/11.d of Joker.com T&C).

 

To protect a registrant from abuse of his data, proxy-privacy.com through EIS AG provides privacy protection services, effectively shielding his information and keeping his data confidential. By using these services, the registrant is represented by alternate contact data provided by EIS AG, while remaining compliant to the registration policies.

The registrant's own data will still be maintained and escrowed by Joker.com, to secure the registrant's ownership of the domain, and to ensure the compliance to ICANN's and registry's policies.

As of now, Privacy Services are available solely for .com and .net domain names. Other Top Level Domains will follow in the near future.

 

Here  is an example of what privacy service means to a domain name's public Whois output:

 

 

Standard Whois Output

With Privacy Basic

With Privacy Pro

Registrant Name: Max Musterman Max Musterman On behalf of yourdomain.com
Registrant Organization: ACME ACME c/o EIS AG, Whois Privacy Services
Registrant Street: Main Street 123

c/o EIS AG, Whois Privacy Services

Baarerstr. 8

Baarerstr. 8
Registrant City: Foo City Zug Zug
Registrant State/Province:  
ABC    
Registrant Postal Code: 54321 6300 6300
Registrant Country: DE CH CH
Registrant Phone: +99.110 12345678 +49 211 867 67 448 +49 211 867 67 448
Registrant Fax: +99.110 12345679 +49 211 867 67 6448 +49 211 867 67 6448
Registrant Email: yourprivatemail@email.com      35b27c46c3d9040b881fc4f@proxy-privacy.com   35b27c46c3d9040b881fc4f@proxy-privacy.com  

 

Please find all details, conditions and the Acceptable Use Policy here: proxy-privacy.com

And here you find all answers on How to enable Whois Privacy?

Prices are available here: Joker.com Pricelist

 

Please note:

 

Examples:

Transfer with privacy service

Let's say a .com domain of you has a remaining term of 5 months, and you want to transfer it to Joker.com, and you chose privacy basic for the transfer.

This would result into

 

mandatory 1 year renewal with transfer:  USD 13.70
optional 1 year privacy basic service: USD   1.49
result - 1 year additional domain term, and 17 months of privacy  USD 15.19

 

Renew with privacy service (I)

Let's say you want to renew a .com domain, which is due to expire in 3 months. With the renew, you want to enable Whois privacy pro:

 

1 year renewal for .com domain:  USD 13.70
1 year privacy pro service: USD   2.49
result - 1 year additional domain term, and 15 months of privacy  USD 16.19
the additional 3 months are "rounded down" - means, they are added, but not charged

 

Renew with privacy service (II)

Let's say you want to renew a .com domain, which is due to expire in 8 months. With the renew, you want to enable Whois privacy pro:

 

1 year renewal for .com domain:  USD 13.70
2 years privacy pro service: USD   4.98
result - 1 year additional domain term, and 20 months of privacy  USD 18.68
the additional 8 months are "rounded up" - means, an additional year of privacy is charged

 

Acquire privacy service for an existing domain (I)

Let's say you own a .com domain, which is due to expire in 13 months. You want to add privacy pro:

 

1 year privacy pro service: USD   2.49
result - domain term is unchanged, and 13 months of privacy 

USD   2.49

the additional 1 month is "rounded down" - means, they are added, but not charged

 

Acquire privacy service for an existing domain (II)

Let's say you own a .com domain, which is due to expire in 3 months. You want to add privacy pro; you will get a warning, because the privacy term cannot exceed the domain's term. You should consider using "Renewal" with privacy option in this case:

 

1 year privacy pro service: USD   2.49
result - domain term is unchanged, and 3 months of privacy 

USD   2.49 

you will only get 3 months of privacy service - you should consider 'renewal' instead

 

 

Last update: 2015-07-29 17:06

How to enable Whois Privacy?

How to enable Whois Privacy Services

 

Please note: Currently, Whois Privacy Services are solely available for .com and .net domains. More Top Level Domains will be supported in the near future.

 

Privacy Services are available for new domain registrations, transfers and renewals - and they can also be applied to existing domains.

Please find all details about the services, pricing and periods here at Whois Privacy Services.

 

Enabling Privacy Services for existing Domains

To order Privacy Services for your existing domains, please either

 

You will then find the Privacy status and options to add within 'Domain Information':

How to add privacy using Domain Settings

 

Register new Domains with Privacy Services

To register a new domain with Privacy Services, please add your domain to the cart as usual, and find the new privacy options directly in the cart - simply click on 'Add Privacy' to select:

 

add privacy to domain order in cart

Renew a Domain and add Privacy Services

When you renew your domains as usual using "Renew Domains" in Service zone, or using a direct link on the Joker.com home page, you will find a new renewal dialogue, which offers the Privacy Services for all applicable domains as easy-to-use check boxes:

Privacy options with Renewal

 

Transfer a Domain and add Privacy Services

We now also offer to apply Privacy Services to domains during a transfer. This is implemented in such a way, that in case a domain which already used privacy services with the former, losing registrar, the Whois data will not be disclosed at any time. To chose privacy options, please start a transfer as usual, and find your choice in section 'Addtional Products' below the AUTH-ID:

 

Privacy options for transfer

 

Last update: 2015-07-29 12:19

1. Website FAQ >> 1.4 Changes of a Domain

How do I modify the properties of a domain?

Please go to our Servicezone to make changes to a domain.

Last update: 2007-03-26 16:18

Who is able to make changes to my domain?

The Joker.com login account which has been used to register a domain is able to modify all aspects of this domain afterwards.

Additionally, permissions ('roles') may be granted to other Joker.com accounts as an option.

Please check here to find out more about those grants and 'roles'.

 

Last update: 2012-09-20 14:42

What can not be changed?

If you order a domain, you are able to control all aspects of this domain:

 

In case you have access to a domain because somebody else assigned you a role ('permissions') for this domain, you only are able to modify aspects limited by this role (=> How to grant roles (= grant permissions to others)?).

Important: You are obliged to enter only valid and true address and identity information for Whois data. This is a requirement of all domain registries. 

 

Last update: 2012-09-20 14:50

Special changes

The following changes must be initiated by the owner of the domain and need special procedures:

Last update: 2011-07-01 09:18

What can be changed?

If you order a domain, you are able to control all aspects of this domain:

 

In case you have access to a domain because somebody else assigned you a role ('permissions') for this domain, you only are able to modify aspects limited by this role.

Please check here to find out more about 'roles'. 

Please also have a look at

Important: You are obliged to enter only valid and true address and identity information for Whois data. This is a requirement of all domain registries. 
 

Last update: 2012-09-20 14:51

How do I transfer a domain to my account if the domain is already at Joker.com, but on another account?

 

=> Please follow this link.

 

Last update: 2012-09-24 13:57

DNSSEC Support

 

What is DNSSEC

DNSSEC is the abbreviation for 'Domain Name System Security Extensions'. It is a set of extensions to the domain name system (DNS), basically to allow clients to verify the authenticity and integrity of DNS records.

For a domain to make use of DNSSEC, the following is needed:

 

You may take this or this as starters for reading more about this topics.

 

DNSSEC Support at Joker.com

Joker.com enables you to 'activate' and configure DNSSEC for your domains - at least for those supporting DNSSEC, of course. These currently are

 

This list will expand as more TLDs implement DNSSEC.

To enable DNSSEC, please enter Joker.com and visit the Service zone=>Domain Settings=>Domain Modification. Chose the (supported) domain you want to edit. Then you will have a button "DNSSEC" to change the DNSSEC settings.

You will find examples there, but you probably need to know a bit about DNSSEC, and also about implementation details of your nameserver provider.

Please note: Joker.com nameservers currently do not yet support DNSSEC records. In case you use the free Joker.com nameservice, you have to engage another nameserver provider.

Resellers will find similar options using DMAPI and RPanel.

 

Last update: 2012-09-20 14:57

1. Website FAQ >> 1.5 Change of Registrar = Transfer of a Domain

How do I transfer a domain to my account if the domain is already at Joker.com, but on another account?

To assign a domain to another Joker.com user, please visit 'Service zone' => 'Domain Settings' => 'Domain - Owner Change '. Enter the domain you want to assign to another user, and proceed with first (default) option checked.

You will be able to provide us with the data of the new owner, including an email address. An invitation email will be sent to this address, containing a verification link. The ownership will be changed in case the verification procedure (clicking on link) has been passed successfully.

In case the new owner does not yet have a Joker.com account, he will be offered to create one automatically.

In case you are a Joker.com Reseller, you may also use the standard domain permission administration (service zone -> modify domain). In this case, you have the choice of assigning permissions or whole domains to other users using an invitation similar to the procedure above, or doing a direct assignment which will be applied immediately.

Course of action [non resellers], summarized:

 

  Resellers additionally may use service zone -> modify domain:


The domain will then be transferred to the user acknowledging the transaction using the invitation email, or to the user owning the ID and the given email address.

 

Last update: 2012-09-20 15:32

How to transfer a domain to Joker.com?

According to ICANN regulations the 'gaining' registrar (Joker.com) has to initiate the process of transferring domains between registrars. To start the procedure, Joker.com has to “obtain express authorization from an individual who has the apparent authority to legally bind the SLD holder (as reflected in the database of the losing Registrar)”.

Please go to 'Transfer Domains' at the main menu of Joker.com to initiate the process. Enter the domain name (without "www.") and provide us with the needed details of your credit card and the desired billing-contact.

To transfer a domain to Joker.com (except .uk domains), you have to provide a so-called AUTH-ID (also known as 'Domain Password'). This ID will prove your authorization regarding to this domain. You have to request this ID from your current Registrar!

During the transfer, you have the choice of keeping the current domain information (whois, nameservers), or to assign new ones. This of course also can be done afterwards in our Service zone.
Course of action summarized in detail:
 

1) Transfer Preparations

At your current/old registrar:

 

2) Initiate the Transfer

Immediately after you submitted the request we will send confirmation emails to the current owner and admin contact of the domain you want to transfer.

To perform the transfer, we need a positive answer from the current admin contact or the owner of the domain.

Please note: All confirmation mails also offer the possibility of using a special link to click instead of returning the mail.

3) Processing the Transfer

After getting the confirmation (details see above), we will charge your credit card. If this attempt succeeds we will forward the transfer request to the registry. The registry in turn will notify your current (old) registrar.

Depending on the procedures of your current (old) registrar, he will ask you, the owner and/or admin-contact for verification by email or otherwise. Be cautious with the emails of your old registrar, some of them are confusing, some start like SPAM, but at the end tells you if you do not answer properly the transfer request will be denied.

4) Finish the Transfer

After approximately 5 days, we will get informed by the registry whether the transfers succeeded or failed. You will be informed immediately after we get this notification. If the transfer succeeded, you can immediately use the domain.
 
In case something goes wrong, please do not hesitate to contact us using this form (please chose topic 'transfer - move domain to Joker.com').
 

Last update: 2017-01-19 10:46

How much does a transfer cost?

Transferring a domain from another registrar to Joker.com will be charged with the fee of registration for one (1) year. If the transfer is successful, we will prolong the life-time of the domain for that one (1) year without charging you additionally.
Please keep in mind that this further year of registration will be added to your registration time, so you will not lose any time from your current registration!
 
Example:
If your domain is about to expire in 7 months when you transfer your domain to us, a successful transfer will cause your domain to expire in 1 year + 7 months = 19 months.
The fee is not refundable if a transfer fails due a reason not caused by Joker.com.
 
Exception:
Transferring your .eu, .de, .nl and .at domains to Joker.com will automatically extend the registration period to 12 months from the date the transfer completes.
When your transfer completes, your domain expiration is extended by one (1) year from the transfer completion date and not from the current expiration date.
This means - if you have 3 months left on your domain, after the transfer you will have 1 year left, not 1 year and 3 months.

In case something goes wrong, please do not hesitate to contact us using this form (please chose topic 'transfer - move domain to joker.com').
A transfer away from Joker.com to another registrar is free of charge, of course.
 
 
 

Last update: 2012-09-20 15:07

How long does it take to transfer a domain to Joker.com?

 

The request to initiate the transfer is submitted instantly to the registry in case:

 

When the losing registrar has been notified about the transfer by the registry, the it may last additional 3-5 days for the losing registrar to react and process the transfer. This of course is not within the scope of Joker.com.

In summary, after a maximum of up to 6 days after the submission of the transfer request to the registry, Joker.com closes the transaction with either status 'successfully transferred' or 'failure').

 

You always may check the status of the domain by asking our 'Search whois' -  please just enter the domain name in question.

 

In case you have problems or additional question, please use 'Support/Contact' to report the problem.

 

Last update: 2012-09-20 15:08

How can I make sure that the current registrar will allow the transfer of my domain?

 

Please check the documentation or FAQ of your current registrar.

Some registrars send mails to their customers and ask for confirmation for the transfer to Joker.com . Unfortunately some of these emails look like SPAM.

Make sure to read them completely and to answer according the rules of the registrar in charge. Other registrars allow outgoing transfer only if the customer has opened a "transfer time window" before the registrar receives a transfer request from the registry.

 

Last update: 2012-09-20 15:09

How do I use name service (DNS) or URL forwarding at Joker.com?

Visit the servicezone at the main menu of Joker.com .

Go to "Domain-Modification" and select the domain for which you want to use the Joker.com nameservice.

Enter
a.ns.joker.com
b.ns.joker.com
c.ns.joker.com
in the nameserver fields and delete all other nameserver entries.

Submit the modification and visit "Nameservice and Webforwarding" in our service zone.

You will notice the appearance of your previously modified domain. Now you can enter all nameserver-zone details for your domain.
Please consider reading the documentation you find on these pages.

Last update: 2007-03-26 17:03

Why can't you take my current name server (DNS) entries?

Some nameserver providers do not allow so called "zone transfers" from their nameservers due to security considerations.

Last update: 2007-03-26 17:04

I got the following error message - 'The current status of "domain-name" didn't allow this operation (transfer)'. What does it mean?

The current status of "domain-name" didn't allow this operation (transfer)

According to the rules of ICANN, a transfer-request fails if at least one of the following situations occurs:

Last update: 2011-07-01 09:41

How to transfer a domain from Joker.com to another registrar?

The protection of a domain name ("domain locking") provides an additional layer of security against unauthorized domain manipulation. It also prevents from fraudulent transfers.

This feature keeps you safe from the notorious people known as domain hijackers. They often spot nice domain names to generate profit from them.

If you decide to transfer a domain from Joker.com to another registrar, all you need to do is unlock your domain.

This can be done in the 'service zone', please see here. The topic is named 'Switch off domain protection'.

After having unlocked your domain, the transfer might be initiated at the other/new registrar. The procedure for the latter differs from registrar to registrar.

 

Additionally, for most domain types the other/new registrar will ask for an 'AUTH-ID'. This AUTH-ID can be requested in the 'service zone'.

Any incoming request for transfer will result in a confirmation email, signalling the transfer to the domain owner (the individual who registered the domain).

After not more than 5 days, the transfer is acknowledged, if you did not explicitly disagree to this transfer.

Disagreement can be expressed through a reply to the confirmation email above, or through clicking a link contained in this email. This email also includes the exact date, at which the transfer will be acknowledged.


Please note:

If the domain is unprotected (unlocked), any incoming request for a transfer will be acknowledged, if there is no response from your side (to explicitly disagree).

Because of this, we strongly recommend to leave your domains protected.

 

Last update: 2012-09-20 15:11

How do I transfer my UK domain to Joker.com?

 

Transferring a .UK domain to Joker.com needs a little help from you:

  1. Please place an order for an UK transfer on our regular Transfer page.
  2. Please ask your current registrar ('tag holder') to change the tag (also known as the IPS Tag) for your domain to "JOKER".
  3. We will add the domain to your account, once Nominet notifies us that the domain has been re-tagged.

If your current registrar will not or can not change your tag for you, then you have the right to ask Nominet to do it for you for a fee:
http://www.nominet.org.uk/registrants/maintain/changeregistrar/

Last update: 2012-09-20 15:20

How do I transfer my UK domain away from Joker.com to another registrar?

Please send an email to transfer@joker.com and provide us the TAG for your new Registrar.

You will have to fetch this information from your new Registrar.

 

Last update: 2012-09-20 15:21

If my domain expires during a domain transfer, will the transfer still be completed?

If your domain transfer was initiated before the the expiration date, the transfer can still be completed. Most domain registrars will let the domain transfer continue if the domain has expired before the transfer has been completed.

There are a few registrars that will manually deny the transfer after the domain has expired. If this worries you, you should contact your previous domain registrar, and ask them if they will still let the domain transfer continue since the transfer was initiated before the domain expired.

Please be aware that a domain transfer does not start right after you submit a domain transfer order to us. A domain transfer starts after the transfer has been authorized. You will receive a "Transfer Initiated" email from us when that happens.

Last update: 2012-09-20 15:22

How to ensure a smooth transfer progress

Before initiating your domain name transferwith us, please be sure that:

 

Last update: 2012-09-20 15:26

1. Website FAQ >> 1.6 Change of Owner

How to Change the Owner of a Domain?

 

If you register a domain with Joker.com, you are the 'owner' of this domain, in the sense that this domain will be added to your domain portfolio, and you always have full control over this domain.

Your role then represents that of the Joker.com "account holder". As of 2016-12-01, this role is also regarded as the "Designated Agent" of a domain (DA).

The responsibilities of a DA are regulated within Joker.com's Terms & Conditions specifically by sections 5b),g),h) and 14b) and d). The definition of the concept of a DA is additionally defined in addendum 1) in the T&C.

 

There also is a contact to be published in Whois called 'owner',  which discloses the official identity of the domain owner according to ICANN and/or Registry requirements.

As with all Whois data, you are enabled to set this Whois owner using the Joker.com domain management. 

 

Please note:

 

 

 

In case you want to re-assign a domain to another person (in the sense of moving a domain into another Joker.com user's portfolio), please visit Joker.com and chose Domain - Change ownership or permissions.  

 

In case you are a Joker.com Reseller, you may also use the standard domain permission administration (My Domains).

You will also find more information about 'roles', 'permissions' and 'assignments' here.

 

In case you want to claim ownership of a domain for yourself, please also visit the section Domain - Change ownership or permissions.

 

Last update: 2016-11-23 15:02

UDRP Decisions

When an arbitrator decides that a domain is to be transferred to the owner of a trademark, this transfer must be initiated by the new owner.
If the proceeding of UDRP is suspended and the involved parties have an agreement to change the owner of the domain, i.e. transfer the domain, the same process must be initiated. In all cases, please add documentation explaining the special reason when sending the request to Joker.com.
 
Note, that during the UDRP proceeding, even if suspended, no "normal" owner change without additional documentation is possible.

Please also consider ICANN:UDRP.
 
You will find the Joker.com procedure in Domain - Owner Change.
 

Last update: 2012-09-20 15:33

Verification of Registrant's Email Address

 

please find this topic here: What about 'Whois Accuracy'?

 

 

Last update: 2014-07-18 12:17

1. Website FAQ >> 1.7 Deletion of a Domain

How to delete a domain?

To delete a domain:

 

 

Last update: 2012-09-20 15:36

Who is allowed to delete a domain?

To delete a domain, you have to be logged in as the owner of the domain in question, this means you need to have administrative permissions on this domain.

 

 

Last update: 2012-09-20 15:37

1. Website FAQ >> 1.8 Renewals

How to renew a domain?

Renewing a domain means adding years to the lifetime of a domain.

You can choose to add from 1 to 5 years. The lifetime will be added to the expiration date, i.e. if you renew before the expiration date you will not lose anything.

Please visit section 'Renewal of a Domain' in Service zone to renew a domain.

Last update: 2011-07-01 12:03

Notifications

The domain owner (the Joker.com account which was used to register the domain) will get notifications by email 
before a domain expires, and
after a domain has expired.
 
Additionally, if there is an 'Admin' or 'Billing' role assigned to this domain, those roles also get notifications
before a domain expires.
You might find out more about 'roles' here.
 

Last update: 2013-10-28 15:57

Who is able to renew the domain?

Domains can be renewed by the owner of a domain (the individual who registered the domain), using the regular renewal procedure. Notifications will be sent by email.
In case if there are roles assigned to this domain, the 'Admin' and/or the 'Billing' role are also enabled to renew a domain.
Please find out more about 'roles' here .
 
In case no authorized person is available, the 'Simple Renewal' procedure can also be used. This allows anybody to renew a domain, but without being able to change any other aspect of the domain. 
 

Last update: 2012-09-20 15:57

Emergency Renewal / Simple Renewal

In case you have difficulties to renew your domain with regular renewal (e.g. because there's a problem with your login account), you may renew a domain by using Simple Renewal.

Everybody can renew a domain using this method, but without gaining access to the domain.


Last update: 2011-07-01 10:40

Auto Renewal

Automatic Domain Renewal

Note: This is currently available for Resellers only

 

If activated, all domains marked as "to be autorenewed" by you will be automatically renewed when due to expire. You will still get the usual renewal reminders - which additionally contain the autorenew status. Please find the complete schedule of renewal notices here. Additionally, 2 special autorenew messages are sent 4 and 2 weeks before expiration.

The actual renewal will happen 7 (seven) days before expiration of the given domain.

 

You can add or remove domains from autorenewal at any time, and you are also able to suspend or reactivate the general mechanism on demand.

 

Important: If not already done, you have to enable 'auto renewal' in the service zone before the flagged domains actually will be autorenewed. Domains in status "expired" (grace period) can not be included in autorenewal, they have to be renewed manually.

Notifications will also be sent before and after an automatic renewal - so you are always up to date!

Autorenew can be configured at these places:

 

 

Last update: 2013-08-29 15:47

My domain expired! Can I still renew it?

You can still renew it within up to 30 days (maximum) after the expiration date. As a courtesy, we keep the domain for this grace period, but it will not be usable.
Please note: You can always use the "simple renewal " procedure to renew any domain, in case the regular renewal is not possible at that moment for you!

After the mentioned grace period, the domain will be deleted automatically (most domains will then automatically enter the
Redemption Grace Period).

The above procedure cannot be used for .eu domains. Please read My .eu domain is in status 'pending-delete'. What should i do?.

To renew a domain, please enter the Servicezone
.

 

Last update: 2012-09-20 16:09

Why does my domain not work anymore?

This might be a 'last reminder' to renew your domain name (Joker.com does send several notifications before this happens - of course the associated email adresses have to be correct).

Just check the domain name in question by asking our 'Search Whois'. Enter the domain name in question.

In case you see the nameserver 'not-renewed.joker.com' associated with your domain name, you should renew as soon as possible (Joker.com adds an additional grace period of up to 30 days to renew the domain).

To renew a domain, please enter the Servicezone

Please also check My domain expired! Can I still renew it?.

If your domain has the nameserver 'not-renewed.joker.com' associated, and you have
already requested a renewal, you have different choices:

 

Last update: 2012-09-20 16:08

Why did I get a renewal notice/bill from another registrar?

Some other registrars or third parties do send renewal announcements for domains which are not registered through them to domains-holders, asking for renewal and transfer to them. That is considered as wrong and misleading by the majority of registrars. We can not stop that bad behaviour. Please report that to ICANN
If you get such a notice, please visit http://Joker.com to check your domain's status before following any other "renewal procedure".
 

Last update: 2012-09-20 16:12

What is a Redemption Grace Period (RGP)?

Most gTld domains - means domains under ICANN regulation - know a special status: Redemption Grace Period, often referred to as "RGP".

What does this mean?
A domain usually will be deleted for two reasons:
A domain will not be deleted immediately from the database of the registry. Instead, for up to 30 days following the deletion, the domain can not be registered again, but the registrar responsible for the domain has the option to "reanimate" the domain again for the registrant. This option in intended to salvage usually rare cases of renewal problems before the final deletion of a domain.

Important: Please note that Joker.com does additionally add a grace period of up to 30 days for expired domains. This means, that for regular expired domains, the 30 days of the "Redemption Grace Period"will start after the 30 days of Joker.com's grace period.
This is also dependent on the type of domain, resp. the registry operating the domain.
A domain name which is in Redemption still can be restored ("re-registered"), using either the Redemption Restore Procedure to restore your domain, or by browsing the pool of all available domains in RGP.
Since most registries regard this to be a special procedure, this usually also has a different price tag. Standard RGP restore fee at Joker.com currently is USD 89.00.
 
Please also note: After a successful restore of a domain name from Redemption, a transfer to another regsitrar is not possible for 30 days.
 
After 30 days in RGP, the status of the domain will change to "pending delete" for 5 days. During these 5 days Joker.com has no possibility to restore the domain name.
During the 6th day after the deletion, the domain is free to be registered again through regular procedures. For rejecting domaingrabbers, the exact time for a new registration is not foreseeable.

However, please note that before Joker.com deletes a domain, the responsible contacts of this domain will be notified several times by email. Please find the exact scheme of notifications in ERRP - Expired Registration Recovery Policy.
 

Last update: 2015-05-13 09:56

My .eu domain is in status 'pending-delete'. What should i do?

Please contact redemption@joker.com to restore it.

Please also consider reading What is a Redemption Grace Period.

 

Last update: 2012-09-20 16:15

1. Website FAQ >> 1.9 Nameservice

How to configure nameservers?

Every domain has to have at least two (2) nameservers.
You can use the Joker.com namerservers

for free, or you may chose your own nameservers. If they already exist, they simply have to be registered with your domain, using "Modify Domain".

If you want to create your own, new nameservers, please have a look at "
How to create a nameserver(-record)?" in this FAQ.
Please go to the Servicezone to modify domain namserver properties, or to add or edit nameserver records (URL-forwarding, mail-forwarding, MX-records etc.).

Please Note: The latter only works with Joker.com nameservers, for technical reasons.

 

Last update: 2012-09-20 16:22

What is a nameservice?

This is a service provided by your internet provider, webhosting company or Joker.com, which is essential if you want to use your domain.

The nameservice makes your domain "reachable" for web- or mail requests, e.g. to assign 'IP adesses' to your web site 'www.your-domain.com'.

Please find more information here.

Last update: 2012-09-21 15:35

What is the difference between a "nameservice record" and "contents of a nameserver"?

The nameservice record describes the ip address of a nameserver associated with a (your) domain.
This domain then has a reference to that record. Use 'Create/Change Nameservers' at our Servicezone for this.
 
The content of the nameserver describes the services you offer, and the corresponding ip addresses for these services (e.g. 'www.my_sample_domain.com' has the ip address '192.168.1.1').
In case you chose Joker.com as your free nameservice provider, use 'Nameservice, Mailaddresses and URL-Forwarding' at our Servicezone for this.
 

Last update: 2012-09-20 16:24

How to create a nameserver(-record)?

Creating nameservers (means, registering a hostname with an ip address to be a nameserver) does only work with Joker.com, if the domain used for these nameservers also is a Joker.com domain.
This is a technical/registry limitiation.

If a domain from another registrar should be used, only this other registrar is able to register these nameservers with the registry.
Of course, just using external, already existing nameservers with any Joker.com domain is fine.

To create a nameserver, you have to

 

 

 

Last update: 2012-09-20 16:26

Who can make changes to a nameserver(-record)?

Only the owner (i.e. the person who created the nameserver) will be able to make modifications. Please be aware:

Last update: 2007-03-27 11:09

Who can make changes to nameserver content?

If Joker.com is providing the nameservice, the owner of a domain (the individual who registered the domain) is able to add nameserver records like IP addresses, email forwarding entries and similar.

Additionally, this owner may assign 'roles' to other Joker.com accounts - the roles 'Admin' and 'DNS-Admin' then also are enabled to enter or modify this sort of domain relevant data.

Please find out more about 'roles' here.

 

Last update: 2012-09-20 16:27

What can be changed (nameserver record)?

Only the ip address of the nameserver may be changed. If the ip address is already in use by another record, it will fail, you will be notified by email. In this case, just use the nameserver which has been already using the desired ip address.

To change the name, simply create a new nameserver record. If the name or the ip number of this nameserver record is already in use by another one, it will fail; you will get an error message by mail.

Last update: 2007-03-27 11:12

How do I change my nameservers?

 

To change the nameservers associated with a domain, please

 

The Update should be visible in Joker-DNS after at most 45 minutes. The old data may linger in some DNS caches for up to 86400 seconds = 1 day.

If you have chosen "Joker.com nameservice", you now may add nameserver entries (records) to your domain, including URL forwarding rules, email adresses or hostname records.

If you have assigned "foreign" Domain Name Servers, you have to use the tools provided by your DNS provider to add records.

 

Last update: 2012-09-20 16:36

How do I configure the Joker nameservers (adding entries)?

To add DNS records, URL and Mail forwards, you have to log into Joker.com and go to the Servicezone.
There you will be presented a list of all your domains which are available for modifications, means, which are using the Joker.com nameservice.
Select the domain you want to have nameservice records added for.

Please chose your desired type of record ("Add New DNS/Service Record"), and click on "Add".

A detailed help is available within the form to add or edit the selected record.

 

Please do not forget to press "Save" after you have done all your edits.

 

 

Last update: 2012-09-20 17:06

How to use the web/URL forwarding feature of Joker.com?

 

Please use the same procedure as described here: How do I configure the Joker nameservers?

 

Last update: 2012-09-20 17:06

How do I configure my nameserver for a .de domain?

Requests to register or update .de domains are handled by a robot doing the following checks on registry side:

 

Last update: 2012-09-20 17:08

What are SOA records and what are the requirements given by DENIC?

SOA stands for "Start of Authority".
A SOA record is the part of a DNS zone containing the responsible person of the zone and the synchronization parameters used by the different name servers of the zone. Requests to register or update domains must contain SOA values in the following ranges:
 
SOA-Record Value
serial recommended format YYYYMMDDnn
refresh [10000 ... 86400]
retry [1800 ... 28800]
expire [604800 ... 3600000]

ttl

 

[180 ... 345600]

Last update: 2012-09-20 17:11

What is Dynamic DNS (DynDNS)?

Introduction

 

Dynamic DNS is a system which allows the domain name data held in a nameserver to be updated in
real time. The most common use for this is in allowing an Internet domain name to be assigned to
a computer with a varying (dynamic) IP address.
This makes it possible for other sites on the Internet to establish connections to the machine
without needing to track the IP address themselves. A common use is for running server
software on a computer that has a dynamic IP address, as is the case with many consumer
Internet service providers.

To use Dynamic DNS records with Joker.com, you have to create at least one Dynamic DNS record.
Additionally, the Dynamic DNS feature has to be activated.
After this, you have to configure your (DSL-) router or your Dynamic DNS
software on your computer.

 

Currently, there is a limit of 20 records per domain. The nameserver records have a TTL (time to live - defines the latency before changes become visible) of 60 seconds.

Please note: The "username" and "password" referred to in this section are not identical with your standard Joker.com credentials. Instead, you will be provided with special credentials when you create  your DynDNS entry, which are only valid for those entries.

 

Examples

 

Hardware Devices

 

A hardware device like a DSL router often is able to handle Dynamic DNS itself. As an example, this is the corresponding section of a Fritz!Box DSL router:
In the menu (web ui), you have to chose "Preferences" => "Internet" => "Dynamic DNS".
You have to enable "Dynamic DNS" with the checkbox. Then choose "Custom" as Dynamic DNS Provider.
The input fields then have to be filled like this:

 

Update-URL: http://svc.joker.com/nic/update?username=<username>&password=<pass>&myip=<ipaddr>&hostname=<domain>
Domain name: <enter your Joker.com Dynamic DNS record (Domain name) here>
Username: <enter the username you got at Joker.com's DNS management for this domain>
Password: <enter the password you got at Joker.com's DNS management for this domain>
Note: SSL is also supported, though not all devices might support this: https://svc.joker.com/nic/update?...

 

Example:

Update-URL: http://svc.joker.com/nic/update?username=<username>&password=<pass>&myip=<ipaddr>&hostname=<domain>
Domain name: www.yourdomain.com
Username: 156ba6fa7f93bfd7
Password: 5bc123a7100ef6a2

 

To check your current IP, you may also use

 http://svc.joker.com/nic/checkip

Some Dynamic DNs clients also make use of this function.
 

Software Clients

 

Windows

 

A popular free Dynamic DNS Windows updater is "DynDNS Updater" from Kana Solution.

 

Please download the latest stable version from their site , and install it. If you use the version with setup program, or start the DynDNS.exe for the first time, you will be presented a "configuration wizard".

 

When it asks for "My Group", enter "Joker". For "Username" and "Password", please use the credentials (see above) you got in Joker.com's service zone.

 

Then please chose "enter manually" when asked for "automatic download". The next dialog allows you to add the hostname or domain you whish to use as Dynamic DNS record, as configured at Joker.com, like "www.yourdomain.com".

 

Finish the rest of the wizard, and leave the program (exit)! Please locate the file "DynDNS.ini" - usually it is in c:\program files\DynDNS Updater (or in the directory you used to extract the package without installer).

 

Open it in an editor (Notepad is fine), and search for the section [Options]. Please add the line

 

IsDynDNS=0

 

and save the file.

 

Then download the text file "joker.profile" attached below, and store it somewhere - e.g. in the DynDNS Updater directory. This text file is the profile to be used for the Joker Dynamic DNS service.

Restart DynDNS Updater, and chose "Settings" (right mouse click on task bar icon).

Select "My Group 'Joker'", click "edit", chose tab "Options", type "joker.com" in inputfield "Provider", and click on the browse button below this. Navigate to the text file you downloaded before, and select it.

 

Leave by pressing "Ok" - and you are done. DynDNS Updater should work now.

 

Linux

 

Popular free clients for Linux:

 

Hints for ddclient

 
 
 

Hints for ez-ipupdate

 

Apple MacOS

 

A dynamic DNS client for MacOS with native Joker.com support is "IP Monitor" from Appquarter.com.

It is also available from the Mac Appstore.

It costs a small amount, but seem to have good ratings...

 

 

 

 

 

Last update: 2016-09-21 13:02

1. Website FAQ >> 1.10 eMail Forwarding

What is eMail Forwarding?

This is a service provided by Joker.com, which allows you to create email addresses for a domain, and to forward incoming emails for those addresses to an existing external mail account.

This means: You could have

info@yourdomain.com
john@yourdomain.com
*@yourdomain.com
...

being forwarded to your emailaccount at your ISP, including free virus- and spam-filtering.

Please be aware that


You can create up to 40 mail addresses per domain. It is also possible to create 'catch all'-addresses: If you enter '*' instead of 'your_name' as 'Mail-Address', all emails not matching any other address you created will go to the '*' entry.
Additionally, a special account 'postmaster' does exist, which can be modified, but not deleted.

Current limits are:


Please note: A newly created mail address (or a changed target address) has to be activated by answering the 'activation email' being sent to the 'Target Mail-Address'

 

 

Last update: 2012-09-21 15:37

How to configure mail forwarding?

 

To configure mail forwarding entries,

 

 

Last update: 2012-09-20 17:24

What about SPAM?

As of now, all mail forwards are automatically filtered for SPAM and viruses.

Mails found to be infected or clearly containing SPAM are blocked.

 

Last update: 2012-09-20 17:30

Who could change a mailforward?

please see Who can make changes to nameserver content?

 

Last update: 2012-09-20 17:31

1. Website FAQ >> 1.11 URL/Web Forward and -Redirect

What is URL Forwarding (Web Forwarding)?

This is a service provided by Joker.com, which allows to point all HTTP (web) requests for a domain (or subdomain) registered with Joker.com to the webspace of a different, extrnally hosted domain, e.g. the webspace which is usually included in ISP contracts.

This feature enables you to access e.g. 'http://www.[your-domain].com', with the real content residing at 'http://www.[your-internet-service-provider].com/[your Account]'.

The redirection is of type 'HTTP/1.1 301 Moved Permanently'.

You can use a standard redirection, or a so-called "frame-based" redirection, which will keep the original domain name visible in your browser's location bar.

You are also able to provide your URL forwards with your own special title-, meta- or HTTP header tags.

 

To configure your URL forwarding, please visit the Service zone: 'Domain Settings' -> ' Nameservice, Mailaddresses and URL-Forwarding', select the domain you want to add URL forwards to, select URL-Forwarding as Record-Type under 'Add New DNS/Service Record' and follow the instructions.

 

Last update: 2012-09-21 15:38

How do I configure URL-Forwarding?

To configure your URL forwarding, please visit the Service zone: 'Domain Settings' -> ' Nameservice, Mailaddresses and URL-Forwarding', select the domain you want to add URL forwards to, select URL-Forwarding as Record-Type under 'Add New DNS/Service Record' and follow the instructions.


You can redirect any domain or hostname/subdomain of a Joker.com domain, to any other domain, being it another Joker.com domain, or an external domain. The redirect-target may contain any URL/path, and also another port or protocol. The redirect can be used with or without frames ("keep URL").

 

Last update: 2012-09-20 17:39

Who could change an URL-Forward?

please see Who can make changes to nameserver content?

Last update: 2011-07-01 11:03

How to see my domain-name in the browser's 'Location'-field?

Please go to the Servicezone, section Nameservice, Mailaddresses and URL-Forwarding.

Then please select the domain name, and either add a new entry "URL-Redirect", or click on "edit" of an existing one.

Mark the checkbox 'keep the URL', if you want your original (sub-)domain ('www.your-domain.com') remaining visible in the browser's 'Location'-field.

 

 



Last update: 2012-09-20 17:44

1. Website FAQ >> 1.12 Domain Contacts

What is a contact?

 

 

please see What are 'contacts'?

 

Last update: 2012-09-21 14:06

Warning: Wrong whois data or invalid address

The owner of a domain (the individual who registered the domain) is responsible for keeping the data of the whois contacts valid. The whois data is the information regarding a domain name which is published through the global "whois service" ("Search whois" on Joker.com).

The owner must make sure that the addresses (email and postal) are in use and that the messages are read.

An invalid address in whois date can be a reason to cancel the domain.

Please also read 'Terms & Conditions' and the provisions of ICANN and the relevant registry which enforces this policy.

 

Last update: 2012-09-21 14:10

How to create or modify a contact?

Login into our Servicezone using your login name and your password.

Select "Advanced Options -> Contact Settings -> create | edit".

Please note: A contact is a kind of 'template', consisting of an email, name and street address.

If you populate a domain with Whois data, you create such a contact (or choose an existing one), and assign this contact to a domain.

You are free to assign individual contacts to each domain, or use a single contact for more than one domain. In this case, it is important to know that in case you change such a contact afterwards, those changes will automatically apply to all domains which have been assigned this contact. 

A contact can be identified by his "contact-id", examples are "CCOM-12345" (.com domains) or "CODE-12345" (.de domains).

Please find out more in What are 'contacts'?

 

Last update: 2012-09-21 14:15

Who can administer/change my domain?

 

 

please see Who is able to make changes to my domain?

 

Last update: 2012-09-21 14:16

How to change a contact (for example new email address)?

Please see 'What can be changed?'.

 

Last update: 2012-09-21 14:17

How to delete a contact?

Contacts can only be deleted if they are not used with any other domain. Joker.com is automatically taking care of this, so it is safe to try  to delete a supposed-to-be-unused contact. If it is yet in use, it will not be deleted.

To delete a contact, chose "Servicezone" => "Advanced Options" => "Contact Settings" => "change".
You will get a list of all your contacts, searching is possible as well. Please click the "delete"-icon as described on this page.

Please note, that modifying a contact which is linked to one of your domains, is also possible by accessing the "Domain - Modifications" section in Servicezone.
 Please also consider reading What are 'contacts'?
 

Last update: 2012-09-21 14:21

1. Website FAQ >> 1.13 Resellers

Reseller related questions

Please visit section Reseller Docs.

 

Last update: 2012-09-21 14:24

1. Website FAQ >> 1.14 Billing and Payment

What is Verified by Visa/Mastercard Secure Code?

Verified by Visa and Mastercard Secure Code is a service introduced by the credit card industry, that uses personal passwords or identity information to help protect credit card owners from unauthorized use.
This additional authentication is used and maintained by the bank who issued the card.
 

Last update: 2012-09-21 14:39

I am not an Internet expert. How easy is Verified by Visa/Mastercard Secure Code to use?

When you submit an order at Joker.com, your credit card will be checked if it participates in the program Verified by Visa/Mastercard Secure Code.
If it does, a window will show up. If you have not yet activated your credit card, simply complete the authentication information requested by your card issuer and create a password. The authentication information could be your date of birth or social security number. Submit and you're done.
Please note: This mechanism is provided by your card issuer (bank), we do not have any influence on this.
 

Last update: 2012-09-21 14:36

I share the same card number with other family members. How does Verified by Visa/Mastercard Secure Code work for all of us?

Whether you and your family members share the same password will be determined by your Visa/Mastercard member bank.
Some member banks require everyone on your account to activate their individual card and create a personal Verified by Visa password/Mastercard Secure ID. Other member banks activate the card for you, in this case, all account holders use the same password.
 

Last update: 2012-09-21 14:41

Can I use Verified by Visa/Mastercard Secure Code from any computer?

Yes. One of the great advantages of Verified by Visa/Mastercard Secure Code is, that it can work with just about any PC with an Internet connection. There is no special software to install.
Once you activate your card, you simply shop as you usually do. Your credit card number is automatically recognized at checkout. Be sure that Cookies and JavaScript are enabled and that pop-up killers are disabled on your computer.
 

Last update: 2012-09-21 14:42

I have a software pop-up killer installed on my computer. Will Verified by Visa/Mastercard Secure Code work for me?

Joker.com has implemented Verified by Visa/Mastercard Secure Code in such a way that your Verified by Visa password/Mastercard Secure Code window will appear in a pop-up, or new browser window.
If you have software installed on your computer that automatically closes browser windows that are not generated by you, then this may also prevent your Verified by Visa password/Mastercard Secure Code window from appearing.
You will need to disable the pop-up killer software when you make purchases at participating online stores.
 

Last update: 2012-09-21 14:43

The popup window is blank/shows an error message/opens again the Joker.com site/doesn't open.

The web site accessed in the popup window is not provided by Joker.com, but from your bank institution. Sometimes there are temporary problems at the bank site and the user gets error messages or a blank window. In this case we can only advice you to contact your bank, explain the issue and try to re-order again later.

Joker.com does only charge once this popup application is terminated successfully, so there is no danger of double charging.

Other problems could be related to misfunctioning modules or non-standard configuration of your browser.
In this case, please try to:

 

Last update: 2012-09-21 14:45

Successful payment by credit card with Verified by Visa/Mastercard Secure Code in Joker.com

When you reach the last step of our order process, you will see a Verified by Visa/Mastercard Secure Code pop-up window.
For a successful completion of your order, you should fill in all the required data fields, and under no circumstances log off from the Joker.com Web site.
A log off from the Joker.com Web site before the final screen where you get your processing ID (Proc ID), will lead to incomplete submission of your order, and thus resulting in immediate automatic cancellation of the domain order.
 

Last update: 2012-09-21 14:48

How long does it take to verify a non-VbV/MSC credit card which is above the limit?

Credit cards which are not participating in the VbV/MSC security measures have to be validated by our staff.

Usually this takes up to 4 hours if your form was received before 12.00 UTC on Friday.

The forms for validation are provided by Joker.com.

 

Last update: 2012-09-21 14:50

I don't have a credit card - How can I pay?

Currently we accept the following payment methods:


 

Last update: 2013-02-12 17:22

My credit card caused problems, but it does work in general!

If you place a lot of separate orders on the same day, you may encounter problems, because credit card clearing may assume double charges.
If you intend to order more than one domain, please try to order them at once.

 

Last update: 2012-09-21 15:01

I received an e-mail about "credit card validation"

Please see 'Credit Card Validation'.

 

Last update: 2012-09-21 15:02

How to validate a virtual credit card?

When you are asked to validate your credit card, we expect you to give us proof of ownership.This is to prevent from fraud with unauthorized credit card numbers.
A copy of a document (contract, receipt etc.), showing that this is your own credit card (your name should be present as well as credit card number) is acceptable. You can either fax or upload that picture using the standard credit card confirmation process form.
 

Last update: 2012-09-21 15:05

The VbV/MSC popup window is too small and I can't see all fields. How to enlarge it?

By using Ctrl + N, you can open the same content in a new window, but in full size. Then it is possible to fill in the required data.

 

Last update: 2012-09-21 15:20

1. Website FAQ >> 1.15 What is...

What is an 'Easy order'?

 

What is Easy Order?

 

Easy order is the fastest and most convenient method for customers to order a domain.
'Easy' means, that you only have to provide a minimum of information to order a domain. Of course, you still may modify all aspects of your domain afterwards.
 
This way, a domain is registered with whois contacts like 'owner', 'admin'm 'tech' etc. being all the same. In case you already do have some other domains with Joker.com, the system automatically provides you with a working contact.
 

The domains are registered using our free of charge namerservers (nameservers are changeable after registration).

 

Last update: 2015-05-19 12:03

What is an 'Advanced order'?

 

What is Advanced Order?

 

Advanced order allows customers to configure all details of the selected domains during the registration.

Different contact data can be entered for owner, admin, tech and billing, as well as custom nameservers (also changeable after registration).

 

Last update: 2015-05-19 12:04

What is a nameservice?

This is a service provided by your internet provider, webhosting company or Joker.com, which is essential if you want to use your domain.

The nameservice makes your domain "reachable" for web- or mail requests, e.g. to assign 'IP adesses' to your web site 'www.your-domain.com'.

Please find more information here.

Last update: 2012-09-21 15:35

What is eMail Forwarding?

This is a service provided by Joker.com, which allows you to create email addresses for a domain, and to forward incoming emails for those addresses to an existing external mail account.

This means: You could have

info@yourdomain.com
john@yourdomain.com
*@yourdomain.com
...

being forwarded to your emailaccount at your ISP, including free virus- and spam-filtering.

Please be aware that


You can create up to 40 mail addresses per domain. It is also possible to create 'catch all'-addresses: If you enter '*' instead of 'your_name' as 'Mail-Address', all emails not matching any other address you created will go to the '*' entry.
Additionally, a special account 'postmaster' does exist, which can be modified, but not deleted.

Current limits are:


Please note: A newly created mail address (or a changed target address) has to be activated by answering the 'activation email' being sent to the 'Target Mail-Address'

 

 

Last update: 2012-09-21 15:37

What is URL Forwarding (Web Forwarding)?

This is a service provided by Joker.com, which allows to point all HTTP (web) requests for a domain (or subdomain) registered with Joker.com to the webspace of a different, extrnally hosted domain, e.g. the webspace which is usually included in ISP contracts.

This feature enables you to access e.g. 'http://www.[your-domain].com', with the real content residing at 'http://www.[your-internet-service-provider].com/[your Account]'.

The redirection is of type 'HTTP/1.1 301 Moved Permanently'.

You can use a standard redirection, or a so-called "frame-based" redirection, which will keep the original domain name visible in your browser's location bar.

You are also able to provide your URL forwards with your own special title-, meta- or HTTP header tags.

 

To configure your URL forwarding, please visit the Service zone: 'Domain Settings' -> ' Nameservice, Mailaddresses and URL-Forwarding', select the domain you want to add URL forwards to, select URL-Forwarding as Record-Type under 'Add New DNS/Service Record' and follow the instructions.

 

Last update: 2012-09-21 15:38

What is Verified by Visa/Mastercard Secure Code?

Verified by Visa and Mastercard Secure Code is a service introduced by the credit card industry, that uses personal passwords or identity information to help protect credit card owners from unauthorized use.
This additional authentication is used and maintained by the bank who issued the card.
 

Last update: 2012-09-21 14:39

What is an AUTH-ID?

Most types of domains have an AUTH-ID code.
The AUTH-ID code is a 6 to 16 character code assigned by the Registrar at the time the name was created. Its purpose is to aid identification of the domain owner, so proper authority can be established (it is the "password" of the domain).
The AUTH-ID mostly is used - and in fact is necessary - for doing transfers. If you want to transfer a domain to Joker.com, you have to request this AUTH-ID for any domain to transfer from your current registrar or ISP.
If you want to transfer a domain from Joker.com to antoher registrar, you may request this AUTH-ID using our Service zone.
 

Last update: 2012-09-21 15:50

What is UTC?

UTC stands for 'Coordinated Universal Time', formerly known as Greenwich Mean Time (GMT). It is a time standard being used and synchronized globally, independant from time zones.

Please find more information here.
Click here for checking what UTC means for your local timezone.

Last update: 2012-09-21 15:56

What are IDN domains?

A few years ago, it was only possible to register domains that contained ASCII characters. This caused difficulties because sometimes domains could not exactly represent the desired string for registration and the customers had to find an alternative name.
Now this is no more an issue thanks to the so called IDN (Internationalized Domain Names) registration. IDN allows you to reserve domain names of all known languages.
The technical process for enabling it could be briefly summarized as a conversion of all entered characters to ASCII characters, thus allowing the existing infrastructure to operate with IDN. The result of such conversion is called PUNYCODE. We show the PUNYCODE presentation in our registration procedure for your convenience and you can also verify it.
Web sites where you can do this are (IDN specific knowledge is required):

 

Last update: 2012-09-21 16:09

How to disable Auto-Complete (memorized passwords, credit card details)?

Joker.com does indicate on all relevant forms, that sensitive information should not be stored by a browser.

However, in case your client card number still automatically appears on the billing page, we recommend that you disable the auto complete function to protect your information.

In MS Internet Explorer:


In Mozilla Firefox:


Last update: 2012-09-21 16:32

What is a 'domain status'?

 

If you query the WHOIS at Joker.com for a domain, you will get one the following domain states:


For security reasons, a domain at Joker.com normally has the status "lock". This is the recommended status of your domains, and means that the domain is secured against fraudulent transfer or modification attempts.

The domain status which will be shown in the WHOIS at Joker.com differs from the status shown by the WHOIS of the responsible registry. They usually show registry-specific status codes.

Last update: 2015-05-13 10:01

What is Credit Card Validation?

Unfortunately, we have to deal with increasing fraud with false credit card numbers. This procedure is dedicated to protect you and us from such unlawful activities.

Recently introduced credit cards - which are known to our system for not more than 60 days - have to be validated always, except if they are taking part in one of the extended security programs:

 

Please also have look here in section 'What is Verified by Visa/Mastercard Secure Code?'.
Validation means, that we kindly ask for a written proof of existance of the used card.
This can be done by faxing or uploading a scan or an appropriate photograph taken by a digital camera.

This validation procedure is triggered automatically, and you are guided through the few necessary steps.

This has to be done only once, and after this, the limit is cleared.

Important: This procedure does also affect the usability of newly ordered domains. Those domains are registered for you, but set to status "hold" und thus not fully usable until payment succeeded.
They will be changed to "production" status as soon as we revceive your confirmation fax.

Only if after a period of 4 days upon date of order, no validation document is received by Joker.com, we have to cancel the order, which means:

 


We apologize for the inconvenience this procedure may cause, but appreciate your cooperation.

If you use Joker.com frequently for your domain orders, you might consider becoming a reseller of Joker.com. As such, you will benefit from bonuses up to 66%, advanced methods of ordering, and no limits.
Please find out more about this at https://joker.com/goto/2bres/

Thank you again for your support, Your team of Joker.com

 

 

Last update: 2012-09-21 17:00

What is an "Invalid address" status?

According to ICANN rules - here WDPRS is relevant - every registrar has to ensure, that whois data of all domains is correct and valid.
Each customer as registrant of a domain, has agreed to this by accepting our and the according registries Terms and Conditions.
When a registrar - like Joker.com - receives a complaint, he has to start a procedure to either make the owner of a domain correct this whois data, or to prove its correctness.
This is policed by ICANN.
Joker.com is doing this in such a way, that the owner and the admin contact of a domain are provided with an email, asking to fax or mail a form, which is attached to this mail, ans also available for download at Joker.com (download section).
If Joker.com does not receive this form within 14 days, the domain will be set on "hold", which means it is not usable any more.
In case you have any questions concerning this, please direct your inquiry to udrp@joker.com.
 

Last update: 2012-09-21 16:54

What is a Redemption Grace Period (RGP)?

Most gTld domains - means domains under ICANN regulation - know a special status: Redemption Grace Period, often referred to as "RGP".

What does this mean?
A domain usually will be deleted for two reasons:
A domain will not be deleted immediately from the database of the registry. Instead, for up to 30 days following the deletion, the domain can not be registered again, but the registrar responsible for the domain has the option to "reanimate" the domain again for the registrant. This option in intended to salvage usually rare cases of renewal problems before the final deletion of a domain.

Important: Please note that Joker.com does additionally add a grace period of up to 30 days for expired domains. This means, that for regular expired domains, the 30 days of the "Redemption Grace Period"will start after the 30 days of Joker.com's grace period.
This is also dependent on the type of domain, resp. the registry operating the domain.
A domain name which is in Redemption still can be restored ("re-registered"), using either the Redemption Restore Procedure to restore your domain, or by browsing the pool of all available domains in RGP.
Since most registries regard this to be a special procedure, this usually also has a different price tag. Standard RGP restore fee at Joker.com currently is USD 89.00.
 
Please also note: After a successful restore of a domain name from Redemption, a transfer to another regsitrar is not possible for 30 days.
 
After 30 days in RGP, the status of the domain will change to "pending delete" for 5 days. During these 5 days Joker.com has no possibility to restore the domain name.
During the 6th day after the deletion, the domain is free to be registered again through regular procedures. For rejecting domaingrabbers, the exact time for a new registration is not foreseeable.

However, please note that before Joker.com deletes a domain, the responsible contacts of this domain will be notified several times by email. Please find the exact scheme of notifications in ERRP - Expired Registration Recovery Policy.
 

Last update: 2015-05-13 09:56

What is Dynamic DNS (DynDNS)?

Please follow 'What is Dynamic DNS (DynDNS)?'

Last update: 2012-09-21 17:01

What is an "OT+E" System?

OT&E means "Operational Test & Evaluation".

Our OT&E system is a kind of "copy" of Joker.com, where special "fake" registries are connected. Domain orders and object manipulations can be performed without having to operate on real data.

This is to allow for resellers to try out their scripts and methods, using Joker.com API and tools.

Our OT&E system mainly consists of 

 In case you are interested in using these systems, please consider to become a reseller of Joker.com. Resellers do also benefit from bonuses of up to 66% on all prices.

 

Last update: 2012-09-21 17:04

What is a domain name's life cycle?

 

It is important to know: When you register a domain name, you do not actually buy it, in fact you are paying for the right of using the domain name for a particular period of time.

Once this period terminates, the registration expires. Before this happens, you will be notified - and have the right to renew the domain name for an additional period.

The life cycles of a domain name may differ, dependent on the type of domain, and how the relevant registry is handling it. Below is illustrated, how the life cycle of a typical generic top level domain looks like:

 

Life Cycle of a Typical gTLD Domain Name

 

LifeCycle

(source of picture: ICANN.org)

Registration (1-10 years)

A domain name usually can be registered for a span of 1 year up to 10 years.

Auto-Renew Grace Period (1-90 Days)

This is the date when the registration period is over. Many individuals have a mis-conception that a domain would become available after that date, which definitely isn’t the fact. Once the domain reaches the expiration stage, there are few other stages before it can be re-registered.

Upon expiration, the domain name may become inactive, though the registrant can still renew it with regular renewal charges. The domain would still stay there in your domain control panel. This stage of the domain life cycle is termed as the auto-renew grace period which would usually be anywhere in between 1 to 45 days (Please find below the Joker.com TLDs Life-Periods). This period varies between registries and registrars.

 

Redemption Grace Period (up to 90 days)

 

Next comes the redemption stage ie. when a domain isn’t renewed by the owner during the grace period, it enters into redemption. Please find the detailed description here: What is a Redemption Grace Period (RGP)?

A typical generic top level domain resides in the Redemption for 30 days before moving onto the next stage. Some country domains (ccTLDs) have longer periods.

 

Pending Delete

 

At this stage, there isn’t any possibility for you to renew it. The registrar sends a command to the Registry for deleting the domain, the domain now enters the last phase of the life cycle called pending delete. The domain stays in this stage usually for 5 days.

 

Released / Available to All

 

As it suggests, the domain becomes available to all and there isn’t any control of anyone.

 

 

These are the Joker.com TLDs Life-Cycle Periods:

 

 TLD  Auto-Renew/Expired Grace Period (days)
 Redemption Grace Period (days)
  Pending Delete (days)
 DE  25   40    0 
 EU  20   40    0 
 AT  0    59    0 
 NL  20   40   0 
 UK  90   90    90 
CH, LI  0    27    40 
 ALL Others  30   30    5 

 

 

 

Last update: 2015-05-15 11:00

What is a 'Premium Domain'?

 

Premium Domains are domains offered by a global network, which Joker.com joined. This means, they are already registered - if ordered with Joker.com, the necessary transfer to you happens transparently and in real time.

Prices cover a wide range - if you need the right domain name for your new business, you probably will find it here.

Please note: You will only find your personal price if you are logged in.

 

Last update: 2013-04-12 14:59

What is an 'Expiring Domain'?

 

Expiring Domains are domains which are already registered with Joker.com, but which have not been renewed by the former owner. You may purchase them right before they are deleted - once they are deleted, they may be gone for ever.

Expiring domains are not 'weighted' by value, we offer them all for the same price, which is mostly set by the registries.

 

The price consists of the regular RGP fee, plus the price for a regular renewal for one year.

 

That's why you really may make a snatch here.

 

Please note: The Joker.com 'Redemption Grace Period" procedure is currently used to move these domains into your portfolio.

 

Last update: 2016-07-04 14:04

ERRP - Expired Registration Recovery Policy

ERRP

According to binding ICANN policies, all ICANN-accredited registrars like Joker.com are obliged to establish certain procedures regarding the communication with domain owners (registrants).

As of 9/01/2013, each registrar has to comply with certain minimum requirements regarding the notification of domain owners (registrants) about the expiration of his domain.

This is part of the ERRP, the "Expired Registration Recovery Policy", and this also includes the obligation of the registrar to send at least two notices to the registrnt before, and one after the eventual expiration of a domain.
Please find more details at ICANN.

 

Timing and number of notices to sent are ruled by ICANN. We adapted the ERRP policy in such a way, that domain owners and registrants do not notice much difference. This is also, because Joker.com always operated very similar to what now became ICANN rule.

Of course, ERRP mails will not be sent if a renewal already happened.

 

This will be the new, complete schedule of all renewal notices issued by Joker.com for domains:

 

Renewal Notices
 sent when  sent to whom ( role )
 60 days before expiration creator (who ordered a domain)
 30 days before expiration creator, admin, billing
 26 days before expiration* owner* (registrant in Whois), creator
 10 days (was: 2 weeks) before expiration creator, admin, billing, owner*
 2 days before expiration creator, admin, billing, owner*
 2 days after expiration owner, creator

*: new mailing, or new adressee

 

 

Last update: 2013-08-29 15:41

What about 'Whois Accuracy'?

 

Beginning with the new domain endings (new gTLDs), ICANN set a new requirement for the data published in the Whois of a domain. The official specification of these new requirements can be found here.

For all generic TLDs (gTLDs), a Whois validation has to be performed by the registrar in the following cases:

 

 

When a new domain is registered or transferred, or the Registrant is modified, we will immediately send an email to the Registrant email address specified for the domain.

 

This email contains a link - by clicking this link, the related email address is registered as verified.

 

The email must be verified within 15 calendar days, otherwise the domain associated with this Registrant's email address might be suspended. In this case, the domain will point to a special landing page.

This landing page will make aware of the problem, and provides information to resolve the problem.

There will be at least three (3) additional notices by email, before the end of the 15-day-period.

 

The verification email will be sent from "joker.com", and the subject is

"Please verify your Email Address for your domain(s)".

 

This verification will only happen once per email address, unless technical problems (e.g. bounces) are recorded, or the Registrant's record is modified.

 

You will always find those of your domains, which are related to a pending verification, clearly marked on your Joker.com's account. You are also able to re-send the verification email again at any time.

 

In case your Registrant's email address contains errors, was mistyped or is otherwise not functional, please modify the related domain(s) and enter a new Registrant's email address, using Joker.com's Service Zone. A new verification link will be sent, and you also may trigger a re-send using your Joker.com's Dashboard.

 

 

Last update: 2014-07-18 12:37

What is 'Email Verification'?

 

please find this topic here: What about 'Whois Accuracy'?

 

 

Last update: 2014-07-18 12:15

What is Two-factor-authentication?

Two-factor-authentication is an optional but highly recommended security feature, that adds an extra layer of protection to your Joker.com account.
Once enabled, you will need a six-digit security code in addition to your password, whenever you log in to Joker.com.
To generate these security codes, you will need a device for this. These two factors – the password, you know, and the smart phone, you have – add an additional layer of security against theft of credentials or dictionary attacks. One of the most common and practical options for this purpose is using a mobile app for your smartphone. Those are usually free of charge, but any device or app which are capable of talking the TOTP protocol should work as well. Here is an incomplete list of some apps:
Google Authenticator (Android, iOS, Blackberry)
Amazon AWS Virtual MFA (Android)
Authenticator (Windows Phone)

Authentikator (Chrome Browser – do not use on same machine!)


During the short procedure to enable two-factor-authentication, you will receive a special 16-digit recovery code.
It is very important that you write this key down and store it somewhere safe.
If you ever lose your phone, or can't receive or generate a security code, you will need this recovery code for emergency access to Joker.com.

 

Please log into your Joker.com account and choose to activate or deactivate two-factor authentication in your Service zone.

Last update: 2016-01-21 14:35

What is 'AuthInfo2'? (.DE domains)

.DE Domains

If the domain holder cannot ask their current provider to obtain a regular AuthInfo from DENIC - e.g. because the provider does not exist anymore, or the domain holder cannot reach the provider - a so called provider change password (AuthInfo2) can also requested from DENIC directly.

 

In this case, the domain holder should contact the provider who is going to administer the domain in the future (e.g. transfer@joker.com).

The provider initiates the generation of an AuthInfo directly at DENIC. DENIC then sends the AuthInfo it has generated to the domain holder by registered letter.

The letter will be addressed to the address recorded in the whois database. In case of domain holders that are not resident in Germany, the letter is addressed to the Admin-C in Germany in order to avoid long delivery times and to guarantee safe delivery.

Parallel to these actions, DENIC records the generated AuthInfo in its database in form of a hash. The domain holder now communicates the AuthInfo to the provider who will administer the domain in the future, and the new provider starts the provider change by submitting the AuthInfo to DENIC.

 

Please send an email to transfer@joker.com, if you need to request an AuthInfo2.

Please note that this procedure may involve fees.

 

Last update: 2016-10-06 17:23

1. Website FAQ >> 1.16 FAQ for specific Top Level Domains

.AT Renewals/Deletion Policy

 

Where can I find an .AT domain's service period?

 It is shown in 'Whois' at Joker.com, and the information is called 'expiration date'.

 

 

What happens when an .AT domain is deleted by the end of the current service period?

The domain can be used until the end of the paid service period. Afterwards, it will be automatically locked, rendering it technically inoperative. The domain’s internet services (website, e-mail) also becomes inoperative as well as the domain’s sub-domains. After this technical lock (presumably 8 weeks) the domain becomes available for a redelegation (can be registered again).

 

What happens if an .AT domain is deleted explicitly?

The registry, NIC.AT, will immediately lock the domain, thus rendering it technically inoperative. The domain’s internet services (website, e-mail) also become inoperative, as well as the domain’s sub-domains. After this technical lock (presumably 8 weeks) the domain becomes available for a redelegation.

 

When can an .AT domain be deleted?

A domain can be deleted at any time.
An .at domain can be deleted until the 28th day before the regular term ends, in case a renewal is not intended. Otherwise the domain fee will be charged for another year and must be paid despite the cancellation.

Joker.com provides within its standard renewal procedures notices and means to handle this requirement appropriately.

In case of non-renewal of an .at domain, and without explicit cancellation (deletion) in due time by the owner, Joker.com will put this .at domain into "Withdraw" state, one (1) day before the end of the regular term, following NIC.AT T&C. The operational status of the domain remains unaffected by this, whereas this Transit includes an administrative migration towards NIC.AT, which will rise additional expense through NIC.AT.

 

 

Who can delete an .AT domain?

The domain can be cancelled (deleted) only by the domain holder – in writing and signed by the proper person or company. The holder thereby abandons all rights and liabilities regarding the domain. Subsequently, the domain can be registered  anew.
Domains that are administered by a nic.at-registrar can also be cancelled directly with the registrar. Please contact your ISP in this case.

 

 

Last update: 2016-01-21 14:39

How do I activate my .XXX domain?

If you are successful with your .XXX domain purchase, you will receive an email from the .XXX domain registry ICM. The email will contain a link which you must click on and complete the steps to the authentication process on the registry's website.

The verification process ensures that .XXX registry ultimately holds verified details for the registrant of the .XXX domain(s).

For more information on .XXX domain applications and policies, please visit ICM registry.

 

Last update: 2014-07-16 13:23

2. Reseller Docs >> 2.2 DMAPI >> Requests >> Account and Handling

login

 

Requires (mandatory):

username Joker.com username (email address)
password Joker.com password

 

Returns:

Auth-SID Authenticated Session ID, must be provided with any other request (parameter auth-sid)
List of TLDs List of domain TLDs which are available to the reseller.

 

To be able to use the entire API, you must have a reseller account with Joker.com (and use this account to log in).

 

 

Example:

 

 

 

  https://dmapi.joker.com/request/login?username=johndoe&password=mypass

 

 

 

 

 

Last update: 2015-06-09 12:31

logout

 

Returns:

nothing


Used to forcibly close (terminate) a session. The session identified by Auth-SID may not be used anymore to send requests. Normally not required as session will timeout anyway (default: 1 hour).
 

Example:

 

  https://dmapi.joker.com/request/logout?auth-sid=<your-current-session-id>

 

 

Last update: 2015-06-09 12:33

result-list

 

Accepts:

pending 

get results of requests still in progress

showall get all results incl. deletes using result-delete
period

get results for specifed period of days (default: 90)

date get results received on (or before) specified date. When date is specified, parameter "period" will be applied to this date (instead of today) and defaults to 1
offset

start dispalying results from specified position

limit only get number of results specified by limit
status

get results having specified status (ack/nack/?)

count-only  

when set to 1, only count number of records and return single line in format "Records: N"

All following filters may use patterns ("*" and "?")

rtype

get results for requests of specified type (domain-register/etc)
objid

get results for specified object ids (domain names, contacts, hosts)

procid get results for specified proc-id
svtrid get results for specifued SvTrId
cltrid get results for specified ClTrId

 

Returns:

List of answers from joker.com (one per line):

TimeStamp SvTrId Proc-ID request-type status ClTrId

 

Where:

 

TimeStamp: The time when request was made, YYYYMMDDHHMMSS
SvTrID: Tracking-Id associated with this request.
Proc-ID: Proc-Id associated with this request.
request-type: The type of the request.
request-object: The object name (host, domain or contact handle)
status: ack, nack or ?, where ack means that request was completed successfully.
ClTrId: User specified transaction ID, or "-" if nothing was provided by the user

 

Example:

 

https://dmapi.joker.com/request/result-list?auth-sid=20ddb8c3b2ea758dcf9fa4c7f46c0784

 

Last update: 2012-10-02 13:46

result-retrieve

 

Accepts:

Proc-ID One of these must be specified. If both are specified, SvTrId has precedence.
SvTrID


Returns:

Answer (processing result) associated with specified Tracking/Processing ID.

If detailed information (content) is not available, only status will be returned

 

Please note:

Since there is no requirement of uniqueness for user-specified transaction ids, it is not possible to use them to retrieve specific results.

 

 

Example:

 

 

 

  https://dmapi.joker.com/request/result-retrieve?proc-id=8181810&auth-sid=<your-current-session-id>

 

 

 

 

 

Last update: 2015-06-09 12:36

result-delete

 

Accepts:

Proc-ID

One of these must be specified. If both are specified, SvTrId has precedence

SvTrID

 

Returns:

A descriptive message (confirmation) in case of success.

This request will delete the content (not the status) of a reply to an asynchronous request. Deleted results will not be listed anymore when using result-list.

 

Semantics of parameters are similar to result-retrieve.

 

Last update: 2015-06-09 12:37

query-profile

 

Returns:

Returns reseller profile data in format "key: value". May be used to query account balance

 

Example:

https://dmapi.joker.com/request/query-profile?auth-sid=20ddb8c3b2ea758dcf9fa4c7f46c0784

 

Last update: 2015-06-09 12:37

2. Reseller Docs >> 2.2 DMAPI >> Requests >> Domains

query-domain-list

Accepts (optional)

pattern Pattern to match (globbing, like "dom*")

from

Start from this item in list

to

End by this item

showstatus   

Returns additional column, showing domain status; may be 0 or 1

showgrants

Returns additional column, showing domain grants; may be 0 or 1

showprivacy

Returns additional columns, showing privacy status; may be 0 or 1

The following columns will be added:

privacy-status - shows the currently active privacy status
privacy-origin - shows the privacy status, which was bought
privacy-expiration - shows the expiration date of privacy

 

Returns

List of registered domains and their expiration dates (one per line, separated by whitespace). If "showstatus" is present, the the list will be with three columns, the last one showing domain status (like "lock,autorenew" etc - comma separated).

 

 

Example:

  https://dmapi.joker.com/request/query-domain-list?pattern=a*&showstatus=1&auth-sid=<your-current-session-id>

 

 

Last update: 2016-11-17 16:55

domain-register

Requires (mandatory)

domain         
Domain name to register
period Registration period in months (not in years!)
status Set domain status (only "production" is accepted so far)
owner-c Owner contact handle
billing-c Billing contact handle
admin-c Administrative contact handle
tech-c Technical contact handle
ns-list List of name servers, delimited by colon


Accepts (optional)

autorenew if set to "1", domain will be autorenewed upon expiration
language

3 letter language code for IDN domains

registrar-tag     

Registrar tag, also known as "Membership token", currently only needed for .XXX domains

privacy

basic|pro|none - adds whois privacy subscription to domain order, see also Whois Privacy Services

 

This request allows to register a domain.

You must have registered contacts (handles) to be able to register a domain.(=> contact-create, query-contact-list)


Important: Please note that the registration period is in months, not years. In most cases, this number is a multiple of 12.

 

 

Example:

  https://dmapi.joker.com/request/domain-register?domain=example.com&period=12&status=production&owner-c=COCO-4711&billing-c=COCO-4712&admin-c=COCO-4712&tech-c=COCO-4712&ns-list=a.ns.joker.com,b.ns.joker.com,c.ns.joker.com&auth-sid=<your-current-session-id>

 

 

Last update: 2016-11-17 16:56

domain-renew

 

Requires (mandatory)

domain domain name to renew
period renewal period in months (not in years!)

expyear

the wanted expiration year (e.g. '2014')

 

Accepts (optional)

privacy       basic|pro|none|keep - adds whois privacy subscription to domain renewal
 

none: explicitly do a renew without privacy services, even if currently privacy is enabled

keep: renew with the same level of privacy service which is currently active for the domain

see also Whois Privacy Services

 

 

With this request you can renew the domain. Please be aware that all renewals are not refundable.

 

"expyear" is a safety option which can be used instead of "period" to renew domain till specified year (not longer). If you use "period", and by mistake send the request more than once, domain will be renewed again, while with "expyear", it will not be renewed if it's expiration year is greater or equals to specified.

Only one of "period" or "expyear" may be used, but not both.

 

Please note:

 

Example:

  https://dmapi.joker.com/request/domain-renew?domain=example.com&period=12&auth-sid=<your-current-session-id

 

 

Last update: 2016-11-17 16:36

domain-modify

Requires (mandatory)

domain domain name to modify

 

Accepts (optional)

billing-c domain contact data to modify
admin-c
tech-c
ns-list   list of new nameservers (it will replace existing nameservers!)
registrar-tag 

Registrar tag, also known as "Membership token", currently used for .XXX domains

dnssec

if specified, allows setting or removal of DNSSEC keys for domain. If not specified, DNSSEC records will not be changed. Value of "0" will remove DNSSEC, value of "1" will add DNSSEC (and ds-N parameters must be provided)

 ds-1            list of DNSSEC parameter sets (min. 2, max. 6) for DNSSEC enabled domains
 ds-2            for com/net/org/tv/cc each entry has format:
 ds-3                tag:alg:digest-type:digest
 ds-4            for de:
 ds-5                protocol:alg:flags:pubkey-base64
 ds-6


With this request you can modify

 

Please only specify contact handles which you want to modify, all unspecified handles will be left as is.

 

For DNSSEC, you will find more information here .

 

 

Example:

  https://dmapi.joker.com/request/domain-modify?ns-list=a.my-own-ns.com,b.my-own-ns.com&auth-sid=<your-current-session-id>

 

Example for adding a key (and enabling DNSSEC):

http://dmapi.joker.com/request/domain-modify?domain=example.de&dnssec=1&ds-1=256:3:5:AwEAAd4TaRzEn0zJfw9w2qkazHTqOX97XwNzoDHMKgClJbX/jr9YGdCYKpTfcKQbVmpI4EVBJOjNWawOJEgpVivw53yHbtEFLOCSYyjwHuXaWiEv0sESNAoPCXQurp4tbHSlnRpyxyzV3dsh9/qUIkJEXxcEuFPaLG3bz1z0Ude6gMXr
http://dmapi.joker.com/request/domain-modify?domain=example.com&dnssec=1&ds-1=38698:5:1:AFE249392848D0458B3967BA1EE9BDEA6C3ECB43

 

Example for removing DNSSEC information:

https://dmapi.joker.com/request/domain-modify?domain=example.com&dnssec=0

 

Last update: 2016-11-17 17:00

domain-delete

Requires (mandatory)

domain domain name to delete

 

Accepts (optional)

force 
if present and set to '1', 'Y' or 'Yes', the domain will be deleted even if older than 72 hours.


With this request you can delete a domain.

If you delete a domain within the first 72 hours after the registration, the registration-fee will be refunded to your account.

To delete a domain which is registered for more than 72 hours, you must specify "force=1", otherwise the request will be rejected.

 

 

Example:

 https://dmapi.joker.com/request/domain-delete?domain=example.com&force=1&auth-sid=<your-current-session-id>

 

 

Last update: 2016-11-17 17:12

domain-owner-change

 

Requires

domain domain name to change the owner of
name (optional) full name (if empty, fname + lname will be used)
fname first name
lname last name
title (optional)
individual (optional) Y, Yes, N, No
organization (optional if individual)
email mailaddress of the contact
address-1 street address
address-2 (optional)
address-3 (optional)
city
state (optional)
postal-code
country ISO country code (2 letters)
phone
extension (optional)
fax (optional)
   
lock-opt-out (optional) yes, no  (new IRTP-C: do not apply a 60 days transfer lock to the domain)


With this request you can change the visible WHOIS owner of a domain.

Either "name" or "lname" and "fname" must be provided. Fields not marked as optional are mandatory, and must not be empty.

For the revised ICANN IRTP-C (change of registrar) policy, please also visit our documentation.

 

Example:

  https://dmapi.joker.com/request/domain-owner-change?domain=example.com&fname=John&lname=Doe&email=johnd@someisp.com&address-1=Smartroad 1&city=Smalltown&postal-code=40122&country=US&phone=+1.422.8001&auth-sid=<your-current-session-id>

 

 

 

 

Last update: 2016-12-07 11:47

domain-lock

Requires (mandatory)

domain domain name to lock


With this request you can lock a domain to prevent from fraudulent transfer attempts.

If a domain is locked, each transfer-request from a foreign registrar will be declined.

 

 

Example:

  https://dmapi.joker.com/request/domain-lock?domain=example.com&auth-sid=<your-current-session-id>

 

 

Last update: 2016-11-17 17:03

domain-unlock

Requires (mandatory)

domain domain name to unlock


With this request you can unlock a domain.

If you want to transfer a domain to a foreign registrar, it has to be unlocked.

 

 

Example:

  https://dmapi.joker.com/request/domain-unlock?domain=example.com&auth-sid=<your-current-session-id>

 

 

Last update: 2016-11-17 17:04

domain-transfer-in-reseller

Requires (mandatory)

domain full qualified domain name to transfer to Joker.com
transfer-auth-id AUTH-ID required for all domains except .eu
owner-c new owner contact handle to be used for transferred domain
admin-c

new admin contact handle

tech-c new tech contact handle
billing-c new billing contact handle

Accepts (optional)

status

new domain status to be set after transfer (lock, production)

period

renewal period in months, not in years! [not in use, please leave empty]

autorenew

Autorenew flag for the domain (0 or 1); if not set explicitly, defaults to 1

ns-list 

list of colon-separated nameservers

privacy basic|pro|none - adds whois privacy subscription to domain transfer, see also Whois Privacy Services


With this request you can initiate a transfer of the domain from another registrar to Joker.com.

You have to provide a valid AUTH-ID (you have to request this from the current provider of the domain).

 

Please note:

 

 

Example:

  https://dmapi.joker.com/request/domain-transfer-in-reseller?domain=example.com&transfer-auth-id=abc123xyz&owner-c=COCO-4711&admin-c=COCO-4712&tech-c=COCO-4712&billing-c=COCO-4712&auth-sid=<your-current-session-id>

 

 

 

Last update: 2016-11-17 17:06

domain-set-property

Requires

domain domain name or pattern
pname property name 
pvalue property value (may be empty)

 

With this request you can set a property (flag) for a domain or a set of domains, selected by wildcard pattern.

 

List of available properties and their effects:

autorenew

0 or 1

If set to 1, the domain will be automatically renewed on expiration (if you have enough funds in your account)

whois-opt-out

 0 or 1

currently only used for .tel domains; if set to 1, owner information will not be shown in whois

privacy

off or basic or pro (if available)

If value provided is empty, then the property will be cleared, i.e. the default will be used.

 

Example:

  https://dmapi.joker.com/request/domain-set-property?domain=example.com&pname=autorenew&pvalue=1&auth-sid=<your-current-session-id>

 

 

Last update: 2016-12-15 15:11

domain-get-property

Requires

domain domain name
pname property name (same as in domain-set-property)

 

With this request you can query the value of a specific property set for a domain.

It returns a single line, which looks like:

autorenew: 0

 

 

Example:

  https://dmapi.joker.com/request/domain-get-property?domain=example.com&pname=autorenew&auth-sid=<your-current-session-id>

 

 

Last update: 2016-11-17 17:09

domain-transfer-get-auth-id

Requires

domain domain name to get AUTH-ID for

 

Retrieves domain's Auth-ID, which is required when transfering domains to another registrar.

This request is not real-time, i.e. you have to check detailed reply (use "result-retrieve") to get the Auth-ID.

 

Please note:

Every request will generate a new Auth-ID, thus rendering any previously requested Auth-ID invalid.

 

 

Example:

https://dmapi.joker.com/request/domain-transfer-get-auth-id?domain=example.com&auth-sid=<your-current-session-id>

 

 

 

Last update: 2016-11-17 17:10

2. Reseller Docs >> 2.2 DMAPI >> Requests >> Contacts

query-contact-list

 

Accepts:

pattern pattern to match (against handle)
from start from this item in list
to end by this item in list
tld limits output to contact handles which may be used with specified toplevel domain (tld), like "com".
extended-format provides additional information for every contact listed: name & organization. May be "1" or "0", defaults to "0"


Returns:

List of registered contacts (handles), one per line.

When "extended-format" is requested, output columns are separated by tabs ("\t"), and "Columns" header provides column names.

 

 

Example:

 

  https://dmapi.joker.com/request/query-contact-list?pattern=coco-47*&tld=com&auth-sid=<your-current-session-id>

 

 

 

 

 

Last update: 2015-06-09 12:43

contact-create

 

Requires:

tld target TLD where this contact is intended to be used.
name full name (if empty, fname + lname will be used)
fname first name (required for .FI contacts)
lname last name (required for .FI contacts)
title (optional)
individual (optional) Y, Yes, N, No
organization (optional if individual)
email mailaddress of the contact
address-1 street address
address-2 (optional)
city
state (optional)
postal-code
country ISO country code (2 letters)
phone
fax (optional)
lang language to use for .EU contacts

app-purpose

required for .US contacts

nexus-category

required for .US contacts
nexus-category-country required for .US contacts
account-type required for .UK contacts, if used as owner contact
company-number

required for .UK contacts with specific account types

orgid

required for .SE/.NU contacts

vatid

(optional) for .SE/.NU contacts

x-ficora-type

required for .FI contacts

x-ficora-is-finnish (Y/N) required for .FI contacts
x-ficora-registernumber required for .FI contacts, if ficora-type is company
x-ficora-identity required for .FI contacts, if type is person and finnish
x-ficora-birthdate required for .FI contacts, if type is persion and not finnish
x-ficora-legalemail (optional) for .FI contacts


Either "name" or "lname" and "fname" must be provided.

Fields not marked '(optional)' are mandatory (and must not be empty).

 

Parameters "lname" and "fname", if provided, will be converted to "name" (simple concatenation of "fname" and "lname"), because registries support only "name" format. In general, use of "fname" and "lname" is deprecated, and support for these fields will be removed in version 1.2.

 

"orgid" represents Swedish personal or organisational number and is required for .SE/.NU contacts.

It starts with ISO 3166 Alpha-2 country code in square brackets. If the country code for Sweden is given [SE] a valid Swedish personal or organisational number must be given (6 digits, dash, 4 digits), otherwise 1 to 123 characters can follow.

If organization is empty and the country code for Sweden [SE] is given, orgid must be a personal number, not an organisational number.

 

"vatid" is optional for .SE/.NU contacts. It starts with a two letter country code (uppercase), followed by an optional space, followed by a country specific string containing digits 0-9, and letters a-z and A-Z, maximum 64 Chars.

 

For .fi contacts:

 

"x-ficora-type" is required for .fi contacts. The following values are accepted: privateperson, company, corporation, institution, politicalparty, township, government, publiccommunity

 

"x-ficora-registernumber" is required if x-ficora-type is set to "company".

 

"x-ficora-is-finnish" is always required for .fi contacts: Y = finnish company or person, N = not a finnish person or company

 

"x-ficora-identity" is required for .fi contacts, if x-ficora-type is set to 'privateperson' and x-ficora-is-finnish is set to 'Y'

 

"x-ficora-birthdate" is required for .fi contacts, if x-ficora-type is set to 'privateperson' and x-ficora-is-finnish is set to 'N' in the following date format "YYYY-MM-DD".

 

 

Please note:

 

 

Example:

 

  https://dmapi.joker.com/request/contact-create?tld=com&name=John Doe&email=johnd@someisp.com&address-1=Smartroad 1&city=Smalltown&postal-code=40122&country=US&phone=+1.422.8001&auth-sid=<your-current-session-id>

 

 

 

 

 

Last update: 2016-09-15 11:21

contact-modify

 

Requires:

handle contact handle to modify.


Accepts:

Field names exactly like in contact-create request, except that omitted fields won't be modified. That is, if you specify a field, it will be used as a new value, if you omit it, the old value will remain.

The field "tld" is not relevant for this request and will be ignored if present.

 

 

Last update: 2015-06-09 12:47

contact-delete

 

Requires:

handle contact handle to delete

 

With this request you can delete previously registered contacts

 

 

Example:

 

  https://dmapi.joker.com/request/contact-delete?handle=coco-4711&auth-sid=<your-current-session-id>

 

 

 

 

 

Last update: 2015-06-09 12:48

2. Reseller Docs >> 2.2 DMAPI >> Requests >> Nameservers

query-ns-list

 

Accepts:

pattern pattern to match (against host name, like "ns.dom*")

full

include IPs if non-zero (0 or 1)

 

Returns:

List of registered name servers, one per line.

If "full" is non-zero, then the list will include IP addresses, IPv4 (2nd column) and IPv6 (3rd column).

Columns will be separated by tab ("\t") character. If specific IP is not present (say, there is only IPv4 or IPv6), it will be listed as "-".

 

Example of list with IPs:

ns.example.com 1.2.3.4 - 
ns6.example.com - FE80:0000:0000:0000:0202:B3FF:FE1E:8329 

 

 

Example:

  https://dmapi.joker.com/request/query-ns-list?pattern=*my-own-ns*&full=1&auth-sid=<your-current-session-id>

 

 

Last update: 2015-06-09 12:55

ns-create

 

Requires:

host Full qualified host name
ip IPv4 address (must not be from IANA's reserved range)
ipv6 IPv6 address (short notation like fec0::17 is accepted)


With this request a new nameserver can be registered with the registry. This is needed to use a nameserver with glue records.

Either an IPv4 or IPv6 address is required.

 

Last update: 2012-09-27 14:58

host-create

 
This is an alias for ns-create.
 

Last update: 2016-10-06 17:27

ns-modify

 

Requires:

host full qualified host name
ip IPv4 address (must not be from IANA's reserved range)
ipv6 IPv6 address (short notation like 'fec0::17' is accepted)


With this request you can modify the IP address of a registered nameserver.

 

Last update: 2012-09-27 15:05

host-modify

 

This is an alias for ns-modify.

 

Last update: 2012-09-27 15:05

ns-delete

 

Requires:

Host Full qualified host name


With this request you can delete a registered nameserver.

 

Last update: 2012-09-27 15:06

host-delete

 

 

This is an alias for ns-delete.

 

Last update: 2012-09-27 15:07

2. Reseller Docs >> 2.2 DMAPI >> Requests >> Modify Zonedata

dns-zone-list

 

Accepts:

pattern Pattern to match (globbing, like "dom*")

 

Returns:

List zones (domains) which are managed and served by Joker.com name
servers. Zones are listed one per line.

 

Last update: 2012-09-27 15:08

dns-zone-get

 

Requires:

domain Zone (domain) name to fetch data from

 

 

Returns:

Returns list of zone records.

The format of zone is as follows (one record per line):

<label> <type> <pri> <target> <ttl> <valid-from> <valid-to> <parameters(s)> 

 

Where:

label

subdomain/redirection label, relative to current zone, or '@' (which means current zone name)

type

record type (A, AAAA, MX, CNAME, URL, MAILFW, TXT, NAPTR, DYNA, DYNAAAA, SRV)

pri

numeric value, meaningful only for types MX, NAPTR and SRV, must be 0 for all other types

target

record target/value. Must be quoted if contains spaces

ttl

record TTL (time to live) in seconds

valid-from

record is not valid before this time (UNIX timestamp) or 0

valid-to

record is not valid after this time (UNIX timestamp) or 0

parameters 

record-specific parameter(s)

 

All values from "name" to "ttl" are mandatory for every record.

<valid-to> and <valid-from> are not implemented yet, so usually are 0, and may be omitted if there are no other parameters required.

<parameters(s)> are record dependent, used in NAPTR, MAILFW, FRAME and URL records.

<ttl> must be at least 60 for all records except NAPTR and SVC, where it can be 0 (meaning: no caching). For MAILFW/URL/FRAME <ttl> is irrelevant and assumed to be 60 seconds (i.e., any change will be
in effect within 60 seconds from zone change).

<pri> preference value for MX records, priority/weight for SRV records and order/preference for NAPTR records. For any other record, the value must be 0.

Examples of zone records:

 

www A 0 127.0.0.1 86400
www AAAA 0 fec0::17 86400

@ MX 10 mail.example.com. 86400

redirect URL 0 http://joker.com 86400

 

Sets redirection from redirect.joker.com to http://joker.com (assuming that current zone is "joker.com").

frame FRAME 0 http://joker.com 86400 0 0 "Header: Frame-Forward" "head" "title" "body"

Sets frame-based redirection similar to URL redirection.

For FRAME record, extra parameters are as follows:


username MAILFW 0 redirected@example.com 86400 0 0 1

This MAILFW records makes redirection of mail sent to username@joker.com (assuming that current zone name is "joker.com") to redirected@example.com, extra parameter ("1") specifies that spam-filtering should be used.

naptr NAPTR 10/100 replacement 86400 0 0 "flags" "service" "regex"

This NAPTR record has order 10 and preference 100. Only one of "replacement" or "regex" may be
specified, if "regex" is specified, "replacement" must be "." (without quotes), if "replacement"
is specified, "regex" must be empty string. Quotes are mandatory for all extra parameters.
For details please consult RFC 2915, or look here: http://de.wikipedia.org/wiki/NAPTR

_ldap._tcp SRV 10/100 ldap.example.com:389 60

This SRV record has priority 10, weight 100, target "ldap.example.com" and port "389" with TTL 60 seconds. Please consult RFC 2782 for details.

txt TXT 0 "key=value" 86400

Quoting of values for TXT records is mandatory.

www CNAME 0 example.com. 86400

Two special record types, DYNA and DYNAAAA, are used in case if DynDNS is active.
They have same meaning as corresponding "A" and "AAAA" records, except that their targets may be updated using Joker DynDNS service.

To enable/disable DynDNS service, and to define username/password used to access it, the record format is as follows:

$dyndns=yes:username:password

username/password may not contain spaces or colon (":") characters. If "no" is specified instead of "yes", DynDNS will be turned off (i.e. DYN* entries will have no effect).

In case if there are any errors, zone modification will not be accepted. All errors will be reported for every erroneous line, so if there are more than one, you will be able to see all detected errors.

 

Last update: 2012-09-27 15:16

dns-zone-put

 

Requires:

domain

Zone (domain) name to store data to

zone

URL encoded zone data

 

 

 

Returns:

Replace current zone for provided domain with specified value.

Field "zone" will be parsed as multiline text (so usual line erminators are expected).

 

Warning: This request will overwrite current zone, i.e. all current ecords will be replaced by new records.

The format of zone is as follows (one record per line):

<label> <type> <pri> <target> <ttl> <valid-from> <valid-to> <parameters(s)>

 

Please find a detailed description of format syntax at section dns-zone-get.

 

Last update: 2012-09-27 15:17

2. Reseller Docs >> 2.2 DMAPI >> Requests >> Rights and Roles

grants-list

 

Requires:

domain

Full qualified domain name

 

Accepts:

showkey Show invitation access key

 

Get a list of active and pending grants.

Returns lines in the following format (space-separated):

invitation <nr> <scope> <key> domain <domain-name> <role> - - - <invitee-email> <nick-name> grant <nr> <scope> domain <domain-name> <role> <inviter-username> <invitee-username> <invitee-userid> <invitee-email> <nick-name> 

 

Where:

<nr> record number
<scope>    Grant/Invite id (used to uniquely identify records for revocation)
<key> Invitation access key, present only when "showkey" is non-zero; it has meaning only for pending invitations, and always is "-" for grants
<domain-name> domain name (identical to domain in request)
<role> one of @admin/@billing/@tech/@creator
<inviter-username> your username (owner of the domain)
<invitee-username> username of invited user
<invitee-userid> [leave empty] user-ID of invited user  
<nick-name> name or comment you want to assign to this role

 


 

Last update: 2012-09-27 15:32

grants-invite

 

Request parameters:

namevalue

mandatory

domain Full qualified domain name

 yes

email

Email of user to be invited to accept a role for 'domain'

 yes

role

Role offered (@admin/@billing/@tech/@creator)

 yes

client-uid

receiving Joker.com user id as shown on Joker.com - also conforms to reseller-id

 no

nick name

Name or comment for this role/grant for later identification (defaults to email)

 no

 

With this request you can assign 'Roles' (permissions) of domains to other Joker.com users. The special role "creator" is an equivalent to an internal transfer of that domain to another Joker.com user. In this case, the domain is assigned to the receiving account's portfolio, including all rights and permissions on this domain.

There are two variants to use this functionality: If the client-uid (Joker.com user account id) is given, and the client-uid matches the associated user's email address in our system, the role is applied immediately - there will be no request for confirmation on the receiver's side. In case the client-uid is not given, but only the email address, the transaction has to be acknowledged by the receiving user. For this, he will get an email ('invitation'), containing a link and a key. Either the link has to be clicked, or the key has to be applied using Joker.com (=> Transfer). This can also be used for users which do not yet have a Joker.com account.

 

Please see more details: How to grant roles (= grant permissions to others)?.

Returns status only (ok or not). Email is sent if request was succesfull.

 

Last update: 2012-09-27 16:32

grants-revoke

 

Requires:

domain full qualified domain name

role

Role to be revoked from domain (@admin/@billing/@tech/@creator)

scope

identifier from 'grants-list' request

type

type of the record to revoke - "grant" or "invitation"

Deletes an issued grant (permission) of a domain, or a pending invitation for a grant.

Returns status only (ok or not). Email is sent if request was succesfull.

 

Last update: 2012-09-27 15:38

2. Reseller Docs >> 2.2 DMAPI >> Requests >> Other

query-object

 

Accepts:

domain  
Domain name Exactly one of those must be specified. Only objects registered with Joker.com may be queried.
contact Contact handle
host Nameserver

 

Returns:

Information about specified object (similar to whois), in format "key: value".

This request is deprecated - please use ' query-whois' instead.

 

Last update: 2014-07-14 13:16

query-whois

 

Accepts:

domain  
Domain name Exactly one of those must be specified. Only objects registered with Joker.com may be queried.
contact Contact handle
host Nameserver

 

Returns:

Information about specified object (similar to whois), in the format "key: value".

The difference to the query-object request is, that this request reflects actual (live) data in Joker.com database, while query-object may show data which not yet up-to-date.


Last update: 2014-07-14 13:16

wa-email-list

Lists all domains and owner emails of domains from your portfolio which are pending whois (email) verification.

For Whois validation, the email address of the owner contact of a newly created, transfered or modifed gTLD has to be verified.This verification is done by sending an email to the owner contact, which contains a unique key in a link. When this link is clicked, the related email address is set to "validated".

 

For full ICANN policy, please see Whois-Validation.

 

Requires:

  -

 

Returns:

  email-address<TAB>domain-name<TAB>verification-expiration-date

 

Where:

 
email-address 
email address of the domain owner which is pending verification
domain-name domain name where email is the owner
verification-expiration-date
verification deadline, i.e. if by this date and time (specified in standard ISO format) email is not positively verified, the domain name listed may be deactivated
 

 

Example:

  https://dmapi.joker.com/request/wa-email-list?auth-sid=<your-current-session-id>

 

 

Last update: 2015-06-09 10:56

wa-email-details

Returns email verification status and the associated domain for provided verification key (whois verification, email validation).If there is more than one domain using the email address to be verified, output will have one line per domain.

 

For full ICANN policy, please see Whois-Validation.

 

Requires:

 

key Verification key sent to owner by verification email


 

Returns:

status<TAB>email<TAB>domain

 

Where:

 
status 
is 'verification', if 'key' is a valid verification key
email email address 'key' has been sent to
domain related domain
 
 

Sample:

https://dmapi.joker.com/request/wa-email-details?key=<key-to-query>&auth-sid=<your-current-session-id>

 

Last update: 2014-07-15 15:27

wa-email-validate

Triggers a new email verification. In case the original verification email got lost or did not succeed otherwise, this request will send a new email. The original key will be automatically included.

This request returns special response header "Result", which will contain "ACK" if the validation request has been sent successfully, or "NACK" otherwise, e.g. if the email address is not in "verification pending" status, or already verified (whois verification, email validation).

 

For full ICANN policy, please see Whois-Validation.

 

Requires:

 

email   Email address to send validation request to. This must be domain owner's email address.


 

Returns:

Result: ACK    validation request has been sent
Result: NACK   no validation request has been sent for this email

 

Sample:

  https://dmapi.joker.com/request/wa-email-validate?email=<email-of-owner>&auth-sid=<your-current-session-id>

 

Last update: 2014-07-15 15:23

wa-email-verify

Set an email address to 'validated' by using the correct key, and voting with 'yes'.

This request returns a special response header "Result", which will contain "ACK" if the verification has been accepted or "NACK" otherwise, e.g. in case the key is not correct (whois verification, email validation).

This is usefull e.g. in case you want to implement your own indivídual landing page for your customers. The URL for this landing page can be set in Joker.com's 'Reseller Settings'.

 

For full ICANN policy, please see Whois-Validation.

 

Requires:

 

key      Verification key sent to owner by verification email
answer Answer to verification request - "yes" or "no"

If the answer is "yes", the verification status is set to "verified" and email is confirmed as valid, if the answer is "no", then verification status is set to "invalid". If there is no answer before verification deadline (normally 15 days), the status is also set to "invalid".

 

Returns:

 

Result: ACK    validation request has been successful
Result: NACK   validation request has been rejected or failed

 

Sample:

  https://dmapi.joker.com/request/wa-email-verify?key=<key-to-use>&answer=[yes|no]&auth-sid=<your-current-session-id>

 

Last update: 2014-07-15 15:23

domain-privacy-order

This request adds a subscription to Whois Privacy Services to an existing domain name.

A summary of all privacy related DMAPI commands is also available at DMAPI Whois Privacy Services.

 

Requires (mandatory):

domain domain name to order privacy service for

privacy

basic|pro

 

Requires (optional):

period renewal period in months (not in years!)

expyear

the wanted expiration year (e.g. '2016')

 

"expyear" is a safety option which can be used instead of "period" to order privacy until the specified year (not longer).

If you use "period", and by mistake send the request more than once, the order would be executed again, while with "expyear", it will not be renewed if it's expiration year is greater or equals to the specified one.

Only one of "period" or "expyear" may be used, but not both.

 

If neither period nor expyear is provided, then privacy is ordered for the remaining domain lifetime, whatever it is.

 

Important: Please note that registration period is in months, not years! In most cases, this number is a multiple of 12.

 

 

Example:

  https://dmapi.joker.com/request/domain-privacy-order?domain=example.com&privacy=pro&auth-sid=<your-current-session-id

 

This would order privacy service "pro" for the same period as the current term of the domain "example.com".
 

Last update: 2015-07-29 11:56

cor-verify

 

Authorizes a 'Change of Registrant' (COR) according to the ICANN IRTP-C policy as of 2016-12-01.

Please find the full documentation of the process at Joker.com here, the original ICANN policy is available here.

 

This request can be used if you did not setup a verification 'push' URL with our provided module (see link above), or you want to use the standard email procedure.

 

This request returns special response header "Result", which will contain "ACK" if the authorization request has been sent successfully, or "NACK" otherwise, e.g. if the key sent does not match the transaction.

 

Requires:

 

key     authorization key (provided in COR confirmation request)
answer answer to confirm the COR - "yes" or "no"

If the answer is "yes", the change-of-registrant will be executed, if in case of "no", it will be rejected. Please also note the new flag 'lock-opt-out' in 'domain-owner-change' if you do not want to lock the domain after the COR for 60 days.
 

Returns:

Result: ACK    authorization key has been accepted
Result: NACK   authorization key has not been accepted

 

Sample:

  https://dmapi.joker.com/request/cor-verify?key=<authorization key sent by Joker.com>&answer=yes&auth-sid=<your-current-session-id>

 

Last update: 2016-11-14 16:10

2. Reseller Docs >> 2.2 DMAPI >> Examples >> Perl

List domains of a customer


#!/usr/bin/perl
use LWP::UserAgent;
use
Data::Dumper;

my $dmapiURL = "https://dmapi.joker.com/request";

my $ua
= LWP::UserAgent-> new;

my $req
= HTTP::Request-> new(GET => $dmapiURL.'/login?username='.shift().'&password='.shift());
my $res = $ua-> request($req);

unless ($res-> is_success) {
print
"Failed: ", $res-> status_line, "n";
exit -
1;
}

my $auth=$res-> as_string;
my $output;

if ($auth =~ /Auth-Sid:s*(w+)/ms) {
$req=HTTP::Request-> new(GET => $dmapiURL.'/query-domain-list?auth-sid='.$1);
$res = $ua-> request($req);
if (
$res-> is_success) {
$output=$res-> content;
}

else{
print
"Failed: ", $res-> status_line, "n";
exit -
2;
}
}

else {
print
"Failed: Got no auth-id from DMAPI:n";
print
$res-> content;
exit -
3;
}


my @lines=split ("n",$output);
my $month=now + ("2M");
my %list;

my $p=0;
for
my $line(@lines) {
#Skip first line
next unless $p or $line =~ /^s*$/;
unless ($p) { $p=1; next};
my ($fqdn,$exp)=split ("[ t]+",$line);
$list{$fqdn}=$exp;
}

for (sort keys %list) {
print
"$_n";
}

 

Last update: 2016-01-13 16:59

List domains to expire next month

Needs:

Class::Date and Date::Parse from CPAN!

#!/usr/bin/perl

use LWP::UserAgent;
use
Data::Dumper;
use Class::
Date qw(:errors date localdate gmdate now -DateParse);

my $dmapiURL
= "
https://dmapi.joker.com/request";

my $ua
= LWP::UserAgent-> new;
my $req = HTTP::Request-> new(GET => $dmapiURL. '/login?username='.shift().'&password='.shift());
my $res = $ua-> request($req);

unless ($res-> is_success) {
print
"Failed: ", $res-> status_line, "n";
exit -
1;
}

my $auth=$res-> as_string;
my $output;

if ($auth =~ /Auth-Sid:s*(w+)/ms) {
$req=HTTP::Request-> new(GET => $dmapiURL. '/query-domain-list?auth-sid='.$1);
$res = $ua-> request($req);

if ($res-> is_success) {
$output=$res-> content;
}
else {
print
"Failed: ", $res-> status_line, "n";
exit -
2;
}
}
else {
print
"Failed: Got no auth-id from DMAPI:n";
print
$res-> content;
exit -
3;
}


my @lines=split ("n",$output);
my $month=now + ("2M");
my %list;

my $p=0;
for
my $line(@lines) {
#Skip first line
next unless $p or $line =~ /^s*$/;
unless ($p) { $p=1; next};
my ($fqdn,$exp)=split ("[ t]+",$line);
next unless localdate($exp) < $month;
$list{$fqdn}=$exp;
}

for ( map {$_-> [0]}
sort {
$a-> [1] < => $b-> [1]
||
$a-> [2] cmp $b-> [2]
}
map {[$_, localdate $list{$_},$_]}
keys %list ) {
print
"$_:".$list{$_}."n";
}

 

Last update: 2012-09-27 15:45

Replace admin-c in multiple domains

 

 

#
# replace admin-c in multiple domains
#
#!/usr/bin/perl
use LWP::UserAgent;
use Data::Dumper;
my $ua = LWP::UserAgent->new;
my $req = HTTP::Request->new(GET => 'https://dmapi.joker.com/request/login?username='.shift().'&password='.shift());
my $res = $ua->request($req);
#--Admin-C :
my %ADMIN = ( de =>'CODE-12345' , org => 'CORG-12345', com => 'CCOM-12345', 'eu' => 'c12345' );
unless ($res->is_success) {
  print "Failed: ", $res->status_line, "\n";
  exit -1;
}
my $auth=$res->as_string;
my $output;
if ($auth =~ /Auth-Sid:\s*([a-z0-9]+)/m ) {
$auth = $1;
} else {
  print "Failed: Got no auth-id from DMAPI:\n";
  print $res->content;
  exit -3;
}
while ( <DATA> ) {
  chomp;
  my $fqdn = $_;
  ## for 3rd level domains this must be changed!
  my ( $sld, $tld ) = split ( /\./ , $fqdn );
  my $admin = $ADMIN{ $tld };
$req=HTTP::Request->new(GET => 'https://dmapi.joker.com/request/domain-modify?domain='.$fqdn.'&admin-c='.$admin.'&auth-sid='.$auth);
$res = $ua->request($req);
  if ($res->is_success) {
$output=$res->content;
     print $output;
  } else {
     print "Failed: ", $res->status_line, "\n";
     exit -2;
  }
}
__DATA__
domain1.de
domain2.eu
domain3.org
domain4.com
__END__


 

Last update: 2016-01-13 16:59

2. Reseller Docs >> 2.2 DMAPI >> Examples >> PHP

Read first - important for PHP examples

 
Please note that there is full DMAPI based interface written in PHP available. It is free to download and modify, and could be downloaded from Sourceforge.
Please read more at section Reseller Control Panel.
The published examples in PHP are parts of this project and are stripped in terms of functionality and error handling. It is strongly recommended to use the complete code base from Sourceforge.
 

Last update: 2016-01-13 16:57

List domains of a customer

 

<?php

//sends HTTP request using CURL

function query_host($conn_server, $params = "", $get_header = false)
{

    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $conn_server.$params);
    if (preg_match("/^https:\/\//i", $conn_server)) {
        curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);
        curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0);
    }

    curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);

    if ($get_header) {
        curl_setopt($ch, CURLOPT_HEADER, 1);
    }

    else {
        curl_setopt($ch, CURLOPT_HEADER, 0);
    }

    $result = curl_exec($ch);

    if (curl_errno($ch)) {
        print "curl error";
    }

    else {
        curl_close($ch);
    }

    return $result;
}

//builds query, sends request and gets the answer back

function execute_request($request, $params, &$sessid)
{
    //build the query
    $http_query = "/request/" . $request . "?" . $params   ."&auth-sid=".$sessid."&client-ip=".$_SERVER["REMOTE_ADDR"];
    //send the request
    $raw_res = query_host("https://dmapi.joker.com", $http_query, true);
    $temp_arr = @explode("\r\n\r\n", $raw_res, 2);
    //split the response for further processing
    if (is_array($temp_arr) && 2 == count($temp_arr)) {
        return $temp_arr[1];
    }

    else {
        return false;
    }
}

//basic parsing of the DMAPI header

function parse_response_header($header)
{
    $raw_arr = explode("\n", trim($header));
    $result = array();
    if (is_array($raw_arr)) {
        foreach ($raw_arr as $key => $value)
        {
            $keyval = array();
            if (preg_match("/^([^\s]+):\s+(.+)\s*$/", $value, $keyval)) {
                $arr[strtolower($keyval[1])] = $keyval[2];
            }

            else {
                print "Header line not parseable - pattern does not match\nRaw header:\n$value";
            }
        }
    }

    else {
        $arr = "";
        print "Unidentified error\nRaw header:\n$header";
    }

    return $arr;
}

//parses the reply from DMAPI into a header and body
function parse_response($res)
{
    $raw_arr = explode("\n\n", trim($res));
    $arr_elements = count($raw_arr);
    if ($arr_elements > 0) {
        $temp["response_header"] = parse_response_header($raw_arr["0"]);
        $temp["response_body"] = $raw_arr["1"];
    }

    else {
        print "Couldn't split the response into response header and response body\nRaw result:\n$res";
        $temp = "";
    }

return $temp;
}

$response = "";
$authid = "none";
//first obtaining an Auth-ID
$username = "<your username here>";
$password = "<your password here>";
$fields = "username=".urlencode($username)."&password=".urlencode($password);
$result = execute_request("login", $fields, $authid);
$result = parse_response($result);
$authid = $result["response_header"]["auth-sid"];
if (!$authid) {
    print "no auth-id was obtained - probably due to wrong username or password";
    exit;
}

//now asking for the domain list
$pattern = "*";
$fields = "pattern=".urlencode($pattern);
$result = execute_request("query-domain-list", $fields, $authid);
$result = parse_response($result);

print_r($result["response_header"]);
print "< br /> ";
print_r($result["response_body"]); 

 

 

Last update: 2016-01-13 16:58

2. Reseller Docs >> 2.2 DMAPI >> Examples >> Python

Intro

Python is easy to use with DMAPI. Our examples are tested with python 2.7 on Linux, but should work on all platforms.

Running the Python example will look like:

 

$ ./dmapi-example.py 
Request-URL:  https://dmapi.ote.joker.com/request/login
Login: Status-Code: 0

Request-URL:  https://dmapi.ote.joker.com/request/query-domain-list
Domain List: Status-Code: 0

 expiration_date: 2018-06-30
 domain: another-privacy-test.com

 expiration_date: 2020-06-30
 domain: another-privacy-test.net

Request-URL:  https://dmapi.ote.joker.com/request/logout
Logout: Status-Code: 0

Last update: 2016-01-15 16:50

Login and list your domains

#!/usr/bin/env python
import requests

dmapiURL = 'https://dmapi.ote.joker.com'
dmapiUser = 'username'
dmapiPassword = 'password'

def main():
    loginResponse = login(dmapiUser,dmapiPassword)
    print "Login: Status-Code:", loginResponse.header['Status-Code']
    if loginResponse.header['Status-Code'] !='0':
    	print loginResponse.header['Status-Text']
    	return

    sessionId = loginResponse.header['Auth-Sid'];
    print ""
    domainResponse = domainList(sessionId,1,5)
    print "Domain List: Status-Code:", domainResponse.header['Status-Code']
    domains = domainResponse.resultListWithNames()
    for domain in domains:
        for key, value in domain.iteritems():
            print " %s: %s" % (key, value)
        print ""
    logoutResponse = logout(sessionId)
    print "Logout: Status-Code:", logoutResponse.header['Status-Code']


# implement dmapi commands as functions
def login(username,password):
    parameters = { 'username': username, 'password': password }
    message = sendCommand('login', parameters)
    return message;

def logout(sessionId):
    parameters = { 'auth-sid': sessionId }
    message = sendCommand('logout', parameters)
    return message;

def domainList(sessionId, list_from=1, list_to=""):
    parameters = { 'auth-sid': sessionId , 'from': list_from, 'to': list_to }
    message = sendCommand('query-domain-list', parameters)
    return message;

# general dmapi command call
def sendCommand(command,parameter={}):
    try:
	url = dmapiURL+'/request/'+command
        print "Request-URL: ", url
        response = requests.get(url, params=parameter)
        # print URL with parameters for debugging purposes
        # print "Request-URL: ", response.url
        if response.status_code != requests.codes.ok:
        	raise CommandError("Command Failed! HTTP Status Code: %s" % response.status_code)
        return DmapiResponse(response.text)
    except requests.ConnectionError as e:
        raise CommandError("Connection Error: %s" % str(e))
    except requests.HTTPError as e:
        raise CommandError("Http Error: %s" % str(e))
    except CommandError as e:
	raise
    except Exception as e:
       raise CommandError("Unexpected Error: %s" % str(e))

class DmapiResponse():
    def __init__(self,responseBody):
        parts = responseBody.split("\n\n",1)
        if parts.count>0:
            self.header = self.__parseKeyValueList(parts[0])
        if parts.count>1:
            self.body = parts[1]

    def __parseKeyValueList(self,text):
        lines = text.split("\n")
        keyValueList = {}
        for line in lines:
            keyValue = line.split(' ',1)
            key = keyValue[0].rstrip(':')
            value = keyValue[1]
            keyValueList[key] = value
        return keyValueList

    def __getSeparator(self):
        if self.header.has_key('Separator') and self.header['Separator'] == 'TAB':
            return "\t"
        else:
            return " "

    def resultList(self):
        lines = self.body.split("\n")
        resultList = []
        separator = self.__getSeparator()
        for line in lines:
            values = line.split(separator)
            resultList.append(line.split(separator))
        return resultList

    def resultListWithNames(self):
        columnNames = self.resultListColumns()
        resultList = []
        if columnNames.count > 0:
            rawList = self.resultList()
            resultList = []
            for row in rawList:
                columns = {}
                for idx, column in enumerate(row):
                    columns[columnNames[idx]] = column
                resultList.append(columns)
        return resultList

    def resultListColumns(self):
        if self.header.has_key('Columns'):
            columnsText = self.header['Columns']
            columns = columnsText.split(',')
            return columns
        else:
            return []

    def resultValues(self):
        return self.__parseKeyValueList(self.body)

class CommandError(Exception):
    def __init__(self, value):
        self.value = value
    def __str__(self):
        return repr(self.value)

# call main function
try:
    main()
except CommandError as e:
    print "Error:", str(e).strip("'")

Last update: 2016-01-13 17:00

2. Reseller Docs >> 2.2 DMAPI >> Examples >> C#

C# / .NET Demonstration /w Code

Applications for domain management with DMAPI are very easy to create using MS Visual Studio. This example code logs into the Joker.com system using DMAPI requests.

It provides a domain listing, whois lookup and "Email verification".

 

This has been tested using Visual Studio 2008 and 2010, but should work with any version, and also with free Visual Studio Express and .NET versions from 3.5 onwards. Please find the source code as an attachment below.

 

We also provide this as a windows binary to try without the need of building it before. In case you run Windows 10 with "Smartscreen", you have to click on "more information" to execute this, since this binray of course is not signed by a "manufacturer"...

 

This is how this will look like:

 

C#/.NEt DMAPI Example

 

 

Last update: 2016-01-20 16:15

2. Reseller Docs >> 2.1 General information

Why would I register as a Reseller?

 
If you register domains frequentlym you should register yourself at JOKER.COM as a reseller.
As a Joker.com reseller, you will not only benefit from Bonuses of up to 66% on all domain prices, but you also will be provided with a set of additional tools to register domains effectively, or to build your own sites for administration.
You will have access to an alternative web interface, an easy to use API and also an email gateway, using PGP-signed mails.
For further information, please go to 'Resellers' .
 

Last update: 2012-09-24 11:59

How to register as Joker.com Reseller?

 

Please click here for more information on how to register as a Joker.com reseller.

 

Last update: 2012-09-24 11:38

Who could become a Reseller?

Any private person or any company is eligible to become a Joker.com reseller.

It is worth considering to become a reseller, if you have 5 domains ore more.

 

Last update: 2012-09-24 12:00

Is there a fee for becoming a Reseller?

No, becoming a Joker.com reseller is free. However, resellers have to fund their account with Joker.com  in advance (pre payment). You are free to decide to what extend to fund your account - bonuses start at USD 100.
Every time you place an order, the amount for this order will be deducted from your account. The higher you fund your account, the bigger the discount you get.
 

Last update: 2012-09-24 12:00

How to update my Reseller data?

To modify your reference data, please login using your reseller account, and click on "Reseller" from the menu on the left. Then please choose "Update reseller data".

 

Last update: 2012-09-24 11:59

How to add existing domains to a Reseller portfolio?

If you decide to let your Joker.com login account migrate to a Joker.com Reseller account, all your domains will be added automatically to this Reseller account.

If you want to 'move' domains owned by addtional, other Joker.com login accounts, you can do this easily using the Roles & Grants system to perform an "Internal Transfer" to the account of choice.

 

Last update: 2012-09-24 12:06

What is the 'admin' email address for?

 
A Joker.com reseller usually has two registered email-addresses with Joker.com, one for the 'robot' emails, and another for administrative tasks.
Reseller news and monthly invoices will be sent to the administrative address.

The 'robot' address corresponds to the standard address associated to the Joker.com login. All notifications resulting from domain orders, renewals and modifications will be sent to this address.
 
This address can be changed easily in Service zone: My Joker.
 

Last update: 2012-09-24 13:24

What is the so called "Additional Whois Signature" for?

 

The "Additional Whois Signature" is part of the data asked during the registration as a Joker.com reseller.

Those input fields are optional, but if you provide them, they will be used to publish your strings in global whois for your domains.

This way your customers are able to identify you as their domain provider.

The strings you provide will be shown as "Sponsoring Reseller".

Last update: 2012-09-24 13:30

What is the Joker.com Public PGP/GPG-Key?

 

This is Joker.com's  public GPG/PGP key - you may use it to verify signed mails sent from Joker.com:

-----BEGIN PGP PUBLIC KEY BLOCK-----
Version: GnuPG v1.0.7 (GNU/Linux)
mIsEPOorJQEEAJauWOOvusxn9GFEPjZnQ3x/48OfaPwSN4cIF5ezpUT6FycZQa+q
eUnNlS+bj80ULXnyyigmkUGwEtW/Qoyd55RM983pr4KtuHSMSU9gCN1syuHlDOAm
71u6irfv5RaHbJXauMCAgUKn+dBNZVZyUTm9aW2pudcwY45apF2tieTZAAYptClq
b2tlci5jb20gc2lnbmVyIHNlcnZpY2UgPGluZm9Aam9rZXIuY29tPoiyBBMBAgAc
BQI8/NifAhsDBAsHAwIDFQIDAxYCAQIeAQIXgAAKCRAm3eE0EUTiIx9RA/9HGDrD
cVM6PjZHr5jpT4svpv7xrjVRn2OIR+s80RuBAnLyAWOflqJ9342SYD8C7BMAqYm4
wXvC3/yvbQEAqsmJ5Bbq2NV+KDepahTtL8SUQ6TkOSUd9NDOvLoQWVI6o1Dz/3MG
HLJfNtx6067Sq8pP8PuYyscPyZ7/uiUilyOrqg==
=O/7Q
-----END PGP PUBLIC KEY BLOCK-----

 

Last update: 2012-09-24 13:48

If I want to leave Joker.com one day, do i have to expect problems transferring my domains?

 

Joker.com respects its customers and allows outgoing transfers. There are no hidden fees.

 

Last update: 2012-09-24 13:58

What is the minimum amount I have to pay in advance to become a reseller?

 

As of now, there is no minimum amount to pay. However, bonus rates begin with an amount of USD 100.

Please also see Joker.com Reseller Subscription.

 

Last update: 2012-09-24 13:59

Do I have to pay VAT?

 

 Only citizens of Switzerland pay VAT.

 

Last update: 2012-09-24 14:01

Why is my account being charged with the same amount as in the price list, I expect a lower reseller amount?

 

At Joker.com, you are granted a bonus of up to 66% at the time when you put funds into your account. This means, you are getting your discount in advance. This additional money is used to 'sponsor' the regular prices, and as a result, you are effectively paying less, depending on your bonus. Those effective prices are show on our price list.

 

Last update: 2012-09-24 14:29

What is the difference between a reseller and a retail customer?

 

As a reseller, you benefit from several additional options:

 

Last update: 2012-09-24 14:37

Should I use PGP?

 

PGP or GPG is only needed in case you want to make use of the email gateway to order, renew or manage domains. If you want to use the API, RPanel or the Website, PGP is not needed.

 

Last update: 2012-09-24 14:40

May I use several methods in parallel to access my domains?

 

Yes, this is possible. However, you should make sure that you don't issue the same orders on the same object twice, i.e. if you you send a renewal request through the mail interface, and do the same using dmapi, the domain will be renewed twice.

 

Last update: 2012-09-24 14:43

How to renew a domain without having funds in my account?

 

You have to choose 'Renewal' => 'Simple Renewal' from the main menu on the left side of our website Joker.com.

You are not required to login for this procedure, you can also register a new account (with email different from your reseller email) for your convenience.

As an alternative, you also may put only some small funds into your reseller account, just to allow for regular renewal.

 

Last update: 2012-09-24 14:49

2. Reseller Docs >> 2.4 Reseller Control Panel

The Reseller Control Panel

 

RPanel Next is the next generation of our Reseller Control Panel. *)

It has been created from scratch, focussed to provide you with the ultimate tool to handle all needs of a domain's business.

The application is pretty self-explanatory, but here is a short list of what's important to know about this tool. But you definitely should give it a try!

 

       

 


*) we are also providing the previous version of Rpanel (V1), now available as rcp.joker.com

 

 

Last update: 2015-12-11 15:42

The Joker PHP Client

 

Joker.com provides this tool as an fully working example of how to make use of the Joker.com API (DMAPI).


The Joker PHP Client is a lightweight web interface, demonstrating how to implement a full-featured domain handling.
The source code of this web interface is freely available for download on Sourceforge, so that our resellers could run it on their own site! The API used in this tool is called 'DMAPI' and it is a Joker.com domain registration system offered as Web service (API).
 
The Joker PHP Client is of course also provided as a hosted service by Joker.com, and can be reached as rcp.joker.com.

Please try it out. Log in with your Joker.com reseller account, and operate carefully with it as it is completely functional. Your feedback as a reseller will be greatly appreciated and will help us to improve this application.
 
Requirements:
    Web server
    PHP 5.x
    Web browser

Summary:
    Reseller Control Panel is destined to handle any domain operations
    which are offered by the domain registrar Joker.com.
    Currently it can:
 
Download:
    You can get the newest version at http://sourceforge.net/projects/joker-client/.

Installation:
    Please see Installation of Joker PHP Client, and there is also an INSTALL file in the distribution package.

Support:
    You can contact us through our support area.
 

Last update: 2015-12-11 15:37

Installation of Joker PHP Client

 

To successfully install this client application, you need a basic knowledge of Web servers, PHP and file systems.

In principle the installation is only a copy and run. The first thing to do is to ensure, that your Web server runs PHP files, and if not to configure it appropriately.

Quick installation:


1. Untar or unzip the distribution (be sure to unzip the subdirectories):

tar -xzvf package_name_x.x.x.tar.gz

in your webserver's document root. If you don't have direct access to your document root, put the files in a directory on your local machine, and transfer the directory on your web server using, for example, ftp.


2. Ensure that all the scripts have the appropriate owner (if PHP is running in safe mode, having some scripts with an owner different from the owner of other scripts will be a problem). Be sure that the application can write log files, temp files and sessions. This means that the folders specified in config.php should be made writeable for the application.


3. This application needs cURL to communicate with DMAPI. You have to have the cURL PHP module enabled. If you run Windows it is provided with every instance of PHP and has to be uncommented in php.ini. Do not forget to restart your webserver after enabling the module. If you run Linux then this module has to be compiled and included. If you wonder how to do this, please read the PHP manual dealing with cURL (http://php.net/curl).

Problems were reported when "zend.ze1_compatibility_mode" is set to "on" in PHP 5.2.5. In lower versions this setting caused no problems.


4. It is recommended that you protect the directory in which you installed the client (unless it's on a closed intranet), for example with HTTP-AUTH (in a .htaccess file).


5. Open the file <www.your-host.com>/<your-install-dir>/index.php in your browser. The Joker.com PHP client should now display a welcome screen with a login dialog.

Have fun and don't forget to send feedback!

 

Last update: 2015-12-10 17:15

Usability Hints

 

Some notes:

 

Last update: 2015-12-10 17:18

2. Reseller Docs >> 2.5 Tools

Domain-Check

 

General Information


This is an additional tool which makes it easy to check if a domain is available for registration. All you have to do is to connect to:

Host whois.joker.com
Port 4343

and issue the command

domain:[sld.tld] [lang=IDN-tag]

 

Technical Issues

 

Examples


Example: "domain:joker.com"

Possible replies are:

status of the domain answer
domain is available: domain:joker.com free
domain is registered already: domain:joker.com registered
domain status is unknown (registry down, etc):

domain:joker.com unknown [optional error text]

 

 

Last update: 2013-02-26 16:04

WHMCS Registrar Module for Joker.com

 

Please see WHMCS Registrar Module.

 

 

 

Last update: 2016-10-07 11:24

2. Reseller Docs >> 2.2 DMAPI >> Basics

Security

 

All transactions are secured by SSL. The DMAPI server is using an official SSL certificate. Within the login procedure, the client is assigned an unique authorisation id ('Auth-Sid').

Every request (except login, of course) requires the presence of this Auth-Sid variable. An active session will expire after a period of inactivity (default: 1 hour).

Example:

 

https://dmapi.joker.com/request/query-domain-list?auth-sid=20ddb8c3b2ea758dcf9fa4c7f46c0784

 

In case you use a browser to access this interface, a session id will be set as a cookie, hence need not to be specified as Auth-Sid (unless cookies are not supported, or turned off). In any case, Auth-Sid has precedence if provided.

 

Last update: 2015-06-09 11:58

Commonalities for all requests

DMAPI-Server URL

This is the service address which has to be used for all requests:

https://dmapi.joker.com

 

This is how a request looks like:

https://dmapi.joker.com/request/<name-of-request>?<name-of-parameter-1>=<value-of-parameter-1>

&<name-of-parameter-2>=<value-of-parameter-2>&auth-sid=<your-session-id>

 

Header fields which are returned by most requests

Tracking Id Unique server-assigned tracking id, assigned to almost all requests 
Status-Code 0 if no error occured, otherwise other than 0
Status-Text Human readable error description
Result ACK or NACK (= "Acknowlegded" or "Not Acknowledged") 
Error May be returned if (and only if) the request was rejected, in this case reason(s) will be provided. Presence of this line in headers is indicative for that processing didn't take place.
Warning Indicative of non-fatal processing or validation problems
Proc-Id Joker.com processing ID 
HTTP error codes 200 if everything is OK (request was accepted and processed or queued for processing), otherwise the reason will be provided in Error header lines (or, if this is absent, HTTP error code should be used).

 

IMPORTANT: Every request (except "login") requires the presence of the Auth-Sid variable ("Session ID"), which is returned by the "login" request (login). An active session will expire after some inactivity period (default: 1 hour).

 

In case you are using a browser to access this service, the session id will be set as a cookie, hence need not to be specified as Auth-Sid (unless cookies are not supported or turned off). In any case, Auth-Sid has precedence, if provided.

 

Requests consist of these parts:

 

Last update: 2015-11-26 11:34

Whois Privacy Services with DMAPI

Whois Privacy Services

 

Please find general details about Joker.com Whois Privacy Services here: Whois Privacy Services

At present, privacy services are available for .com and .net domain names.

 

For requests "domain-register" and "domain-transfer-in-reseller", there exists an additional parameter "privacy":

 

For "domain-renew", the additional parameter privacy works similar:

 

To order privacy services for existing domains, the new request "domain-privacy-order"can be used:

    domain=example.com
    period=12 (in months, as usual)
    expyear=2016 (privacy expiration year, similar to domain renewal request)
    privacy=basic|pro 

    If neither period nor expyear is provided, then privacy is ordered for
    remaining domain lifetime, whatever it is.

Example:
https://dmapi.joker.com/request/domain-privacy-order?domain=example.com&privacy=basic&auth-sid=<your-current-session-id>

 

The request "domain-set-property" allows to manage privacy services for domains which already do have a valid privacy service subscription:

 

Samples:

Ordering domain with privacy:

https://dmapi.joker.com/request/domain-register?domain=example.com&period=12&owner-c=CCOM-1&billing-c=CCOM-1&admin-c=CCOM-1&tech-c=CCOM-1&ns-list=a.ns.joker.com:b.ns.joker.com&privacy=pro&auth-sid=<your-current-session-id>

 

Renew domain and order privacy:

https://dmapi.joker.com/request/domain-register?domain=example.com&period=12&privacy=basic&auth-sid=<your-current-session-id>

 

Request incoming transfer and enable privacy:

https://dmapi.joker.com/request/domain-transfer-in-reseller?domain=example.com&transfer-auth-id=zigzag&billing-c=CCOM-1&admin-c=CCOM-1&tech-c=CCOM-1&privacy=pro&auth-sid=<your-current-session-id>

 

Temporarily disable privacy (assuming that it is active):

https://dmapi.joker.com/request/domain-set-property?domain=example.com&privacy=off&auth-sid=<your-current-session-id>

 

Fetch real contact data from privacy protected domain:

https://dmapi.joker.com/request/query-whois?domain=example.com&internal=1&auth-sid=<your-current-session-id>

 

Last update: 2016-12-15 15:17

Differences to Email Gateway

 

The main differences in handling between DMAPI and Email Gateway at Joker.com are:


NOTE: Not retrieved replies will be kept on the server for a period of 30 days, after this time,  only the status of specific request will be available (success or failure).

IMPORTANT: Please also note that the registration/renewal period is in MONTHS, NOT YEARS! This is to allow future micro-registrations.

 

Last update: 2016-04-04 13:43

2. Reseller Docs >> 2.2 DMAPI >> Plugins & Interfaces

WHMCS Registrar Module

 

WHMCS is a popular web hosting and automation solution, which includes billing and support options.WHMCS Joker.com Registrar Module

If you are using WHMCS for your hosting activities, you may interface Joker.com  with WHMCS' domain functionality to easily order and manage domains from within WHMCS.

 

Joker.com maintains a registrar module for WHMCS, which offers a great load of  features to interface Joker.com seamlessly from within WHMCS:

 

The following registrar core functionality is provided:


Additionally, also these features are provided:

 

 

This version has been tested with WHMCS 6.x and WHMCS 7.0.

Installation:
Please put the contents of the below attached archive into the folder modules/registrars/joker/
of your WHMCS installation.
The configuration of the Joker.com registrar module is done by using the WHMCS admin section. For this, please login as "admin" into your WHMCS installation, and navigate to

Setup -> Products/Services -> Domain Registrars

Pick "Joker.com" from the list, "Activate" the plugin, and enter your Joker.com
Reseller's credentials - the same you are using for DMAPI.


You also may choose to use the "TestMode" for dry run on our OT&E platform, or to configure the free Joker.com nameservers as a default for new domains.
Once activated, you may always change these settings by clicking on "Configure".
Don't forget to "Save Changes" after doing so.


Usage:
You will find most options for domain in section "Clients -> Domain registration" within the domain details.
A special command there is "Sync" - this will trigger a manual sync of a domain's status and expiration date with Joker.com, in case it was modified outside of WHMCS. This is usually also done automatically by the 'WHMCS domainsync cron'.


Please send us your feedback: reseller-support@joker.com
Enjoy!

Last update: 2016-10-07 11:29

Simple WHMCS Plugin

WHMCS Hosting & Billing Plugin 

WHMCS is a popular web hosting and automation solution, which includes billing and support options.

If you are using WHMCS for your hosting activities, you may interface Joker.com with WHMCS' domain functionality to easily order and manage domains from within WHMCS.

 

This is a very light weight and simple plugin, therefore very easy to install (you will find instructions in the readme of the zip archive below).

However, features are basic, and you have to configure a fixed set of contact handles for each TLD you want to use.

Any TLD of Joker.com should work.

 

This plugin is provided as an example to show, how easy it is to connect Joker.com to WHMCS using DMAPI. You may also use it as a starting point for your own experiments.

 

For a full integration of Joker.com into WHMCS, please use our official fully-featured Joker.com WHMCS Registrar Module.

 

 

Last update: 2016-04-11 14:06

2. Reseller Docs >> 2.3 Email Gateway >> Basics

How does the PGP/GPG-Mailinterface work?

 

Using the Joker.com email interface, you may send 'commands' to a special address at Joker.com by email. Those commands may consist of registration orders, domain renewals or modifications.

The Joker.com mail interface address is disclosed once you signed up as a reseller.

The emails making up the commands follow a simple format, which is described here in section 'Requests'.


For security reasons, each request which is sent to the mail gateway has to be signed using PGP or GPG. This means, you need to have a pgp/gpg-installation on your machine. Some tools which can be used for this:

Emails which are not signed correctly will not be processed. All requests to the gateway have to be sent as PGP/GPG signed mails to the Joker mail-robot (you will receive the exact address if you have registered yourself as a reseller).

Mails are expected to be sent in the "traditional" format (signature is part of the message body), not (for example) in MIME encapsulated format!

The actual request (the command to be peroformed) has to be put into the subject of the email. Further details (for example the full qualified domain name) have to be put in the message body.

Example:

Subject: modify domain

-----BEGIN PGP SIGNED MESSAGE-----

Hash: SHA1


tld:org

sld:dummy

ns1-handle:ns1.dummy.org

ns2-handle:ns2.dummy.org


-----BEGIN PGP SIGNATURE-----

Version: GnuPG v1.0.2 (GNU/Linux)

Comment: For info see http://www.gnupg.org


iD7DBQE6ZtMfzWqd+drNYRURAuW4AJ4nRewOrNc+yLMmmCouVcMP3v5nWQCdHUlf

tJk/gOuFmDnIs3JS+7eRjnA=

=Fwmc

-----END PGP SIGNATURE-----

 

Last update: 2012-10-11 10:19

Where are the replies of the mail-gateway sent?

The replies of the gateway are generally sent to the "reply-to"-address. In order to specify that address, you will have to fill in the reply-to-field within the e-mails you send to the mail-gateway.

Last update: 2007-03-27 15:15

How do I change my robot-email-address?

The Joker.com system identifies you using your pgp-signature and your email-address, so you have to provide a new pgp-key, if you want to change your robot-email-address. Without changing the pgp-key, our system cannot grant you access to the domains, you have registered at joker.com.

Please, follow the 3 steps below to change your robot-email-address

  1. Create a new contact with your new email-address using the mail-gateway.

  2. Change the billing-c of all your domains using this new contact, which contains the new robot-email-address. Use the "list domains"-request for a listing of your domains.

  3. Go to https://joker.com/index.joker?mode=resellerpages&stage=step13b and provide your new email-address and your new pgp-key and wait for our response mail.

Last update: 2007-03-27 15:23

What is the Joker.com public key?

Please verify e-mails from Joker.com using the following public key:

  

-----BEGIN PGP PUBLIC KEY BLOCK-----
Version: GnuPG v1.0.7 (GNU/Linux)
mIsEPOorJQEEAJauWOOvusxn9GFEPjZnQ3x/48OfaPwSN4cIF5ezpUT6FycZQa+q
eUnNlS+bj80ULXnyyigmkUGwEtW/Qoyd55RM983pr4KtuHSMSU9gCN1syuHlDOAm
71u6irfv5RaHbJXauMCAgUKn+dBNZVZyUTm9aW2pudcwY45apF2tieTZAAYptClq
b2tlci5jb20gc2lnbmVyIHNlcnZpY2UgPGluZm9Aam9rZXIuY29tPoiyBBMBAgAc
BQI8/NifAhsDBAsHAwIDFQIDAxYCAQIeAQIXgAAKCRAm3eE0EUTiIx9RA/9HGDrD
cVM6PjZHr5jpT4svpv7xrjVRn2OIR+s80RuBAnLyAWOflqJ9342SYD8C7BMAqYm4
wXvC3/yvbQEAqsmJ5Bbq2NV+KDepahTtL8SUQ6TkOSUd9NDOvLoQWVI6o1Dz/3MG
HLJfNtx6067Sq8pP8PuYyscPyZ7/uiUilyOrqg==
=O/7Q
-----END PGP PUBLIC KEY BLOCK-----

Last update: 2007-03-30 15:48

Should I use PGP or GPG?

It does not matter if you use PGP or GPG, the version is not important as well. Just make sure that your program is able to put PGP signatures into your mail in the format described above.

Please have a look at the following web sites to get the newest versions and lots of explanation on the programs.
 
http://www.pgpi.org/

http://www.gnupg.org/  

 

ATTENTION:

Users of GPG have to use the following flag:

gpg --clearsign --force-v3-sigs ....

Otherwise our system will reject your signed mails.

Last update: 2007-03-30 15:53

2. Reseller Docs >> 2.3 Email Gateway >> Requests

General Instructions

 
All requests do follow the same scheme:
You have to send the request as signed email to the Joker.com  mail gateway address. This address is disclosed once you signed up as a reseller of Joker.com.

Each email uses a simple, special format, which is described under the different request-types.

For security reasons you have to pgp-sign each mail you send to the mail-gateway, so you need a pgp-installation on your machine. Unsigned or invalid mails will be ignored.

Emails without a valid subject (request-type) will produce an error. In this case you will receive an error message as response.
Valid requests are normaly processed in realtime. Under certain circumstances (Registry-Downtimes, System maintenance, etc.) it is possible, that requests have to wait for processing. It is highly recommended to ask our support before you repeat such requests.

 

The descriptions for the requests do all follow the same scheme:
Topic 'introduction' - a short introduction of the request, what is the request for.

Topic 'request fields'

 

Last update: 2012-10-11 10:29

List of currently working requests

Here you will find the list of the currently working requests. there are 2 types of status for each request.

All requests marked with "not yet implemented" will be available during the next weeks.

target request-type status
.com/.net support available
create order available
change owner available
change address available
transfer domain available
renew domain available
delete domain available
modify domain available
create contact available
modify contact available
create nameserver available
modify nameserver available
list domains available
lock domain available
unlock domain available
.org support available
create org-order available
change org-owner available
change org-address available
transfer org-domain available
renew org-domain available
delete org-domain available
modify org-domain available
create org-contact available
modify org-contact available
create org-nameserver available
modify org-nameserver available
list domains available
lock domain available
unlock domain available
get auth-id available
.info support available
create info-order available
change info-owner available
change info-address available
transfer info-domain available
renew info-domain available
delete info-domain available
modify info-domain available
create info-contact available
modify info-contact available
create info-nameserver available
modify info-nameserver available
list domains available
lock domain available
unlock domain available
get auth-id available
.biz support available
create biz-order available
change biz-owner available
change biz-address available
transfer biz-domain available
renew biz-domain available
delete biz-domain available
modify biz-domain available
create biz-contact available
modify biz-contact available
create biz-nameserver available
modify biz-nameserver available
list domains available
lock domain available
unlock domain available
get auth-id available
.de support available
create de-order available
change de-owner available
change de-address available
transfer de-domain available
renew de-domain available
delete de-domain available
modify de-domain available
create de-contact available
modify de-contact available
create de-nameserver available
modify de-nameserver available
list domains available
lock domain available
unlock domain available
.eu support available
create eu-order available
change eu-owner available
change eu-address available
transfer eu-domain available
renew eu-domain available
delete eu-domain available
modify eu-domain available
create eu-contact available
modify eu-contact available
create eu-nameserver available
modify eu-nameserver available
list domains available
lock domain available
unlock domain available
get auth-id available
.cn support available
create cn-order available
change cn-owner available
change cn-address available
transfer cn-domain available
renew cn-domain available
delete cn-domain available
modify cn-domain available
create cn-contact available
modify cn-contact available
create cn-nameserver available
modify cn-nameserver available
list domains available
lock domain available
unlock domain available
get auth-id available
.us support available
create us-order available
change us-owner available
change us-address available
transfer us-domain available
renew us-domain available
delete us-domain available
modify us-domain available
create us-contact available
modify us-contact available
create us-nameserver available
modify us-nameserver available
list domains available
lock domain available
unlock domain available
get auth-id available
.me support available
create me-order available
change me-owner available
change me-address available
transfer me-domain available
renew me-domain available
delete me-domain available
modify me-domain available
create me-contact available
modify me-contact available
create me-nameserver available
modify me-nameserver available
list domains available
lock domain available
unlock domain available
get auth-id available
.asia support available
create asia-order available
change asia-owner available
change asia-address available
transfer asia-domain available
renew asia-domain available
delete asia-domain available
modify asia-domain available
create asia-contact available
modify asia-contact available
create asia-nameserver available
modify asia-nameserver available
list domains available
lock domain available
unlock domain available
get auth-id available
.mobi support available
create mobi-order available
change mobi-owner available
change mobi-address available
transfer mobi-domain available
renew mobi-domain available
delete mobi-domain available
modify mobi-domain available
create mobi-contact available
modify mobi-contact available
create mobi-nameserver available
modify mobi-nameserver available
list domains available
lock domain available
unlock domain available
get auth-id available
.name support available
create name-order available
change name-owner available
change name-address available
transfer name-domain available
renew name-domain available
delete name-domain available
modify name-domain available
create name-contact available
modify name-contact available
create name-nameserver available
modify name-nameserver available
list domains available
lock domain available
unlock domain available
get auth-id available
nameservice/urlforwarding create dns-config available
delete dns-config available
list dns-config available

Last update: 2008-08-14 11:31

2. Reseller Docs >> 2.3 Email Gateway >> Tools

CheckD

please see section '2.5 Tools': Domain-Check

 

Last update: 2009-04-02 12:14

2. Reseller Docs >> 2.3 Email Gateway >> Examples

Complete set of examples for download

 

We offer all examples summarized in a textfile. The file is attached to this article. As it has a lot of examples, it is recommended to use the search function of your text editor to find information.

 

Last update: 2012-09-27 16:33

2. Reseller Docs >> 2.3 Email Gateway >> Requests >> Macros

What is a macro?

A macro is used within the definition of a request.

A macro starts with an @.

Example: @cont or @email or @ns


Every time you find a macro, please check the definition of this macro for further information.

Last update: 2007-04-02 15:20

E-mail Address

@email

This means an email address in the following format:

Valid values (.com/.net only):
foo@bar.com
foo@bar.com#1
foo@bar.com#15

Invalid values:
Hans Nase <hans@foo.com>
hans@foo.com (Hans Nase)


Valid values (.org/.info/.biz/.de/.cn only):
foo@bar.com
foo-bar@bar.com

Invalid values:
Hans Nase <hans@foo.com>
hans@foo.com (Hans Nase)
foo@bar.com#15

Last update: 2011-08-11 15:34

.com/.net 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 and we will add a numerical suffix to the email address that starts with "0" and increases by "1" for every existing contact with such a emailaddress in the JOKER-DATABASE.


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

request-field valid values required
".."-individual [YN] yes
".."-lname [\x20-\x7e]{0,80} yes, if individual = Y
".."-fname [\x20-\x7e]{0,80} yes, if individual = Y
".."-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
".."-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 (@cont or @same-as) (.com/.net only)

This means an existing contact handle in the JOKER-DATABASE.

Examples:


owner-contact-handle:foo@bar.com#0
admin-contact-handle:foo@bar.com
tech-contact-handle:foo@bar.com#15
billing-contact-handle:foo@bar.com#15

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 (.com/.net)-requests, contact handles for (.info)-contacts are not allowed. If you are referencing to a shortcut like C00783-LRMS, you will get an error.

Last update: 2007-04-17 22:05

.com 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 CCOM-<number>,

 

e.g. CCOM-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 (@comcont or @same-as) (.com only)

This means an existing contact handle in the JOKER-DATABASE.

Examples:

owner-contact-handle:CCOM-176269
admin-contact-handle:CCOM-176229
tech-contact-handle:CCOM-176269
billing-contact-handle:CCOM-176269

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 .com-requests the contact handles for (.com/.net)-contacts are not allowed. If you are referencing to a shortcut like hans@nose.net#1, you will get an error.

Last update: 2015-11-09 17:47

.net 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 CNET-<number>, e.g. CNET-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 (@netcont or @same-as) (.net only)

This means an existing contact handle in the JOKER-DATABASE.

Examples:

owner-contact-handle:CNET-176269
admin-contact-handle:
CNET-176229
tech-contact-handle:
CNET-176269
billing-contact-handle:
CNET-176269

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 .net-requests the contact handles for (.com/.net)-contacts are not allowed. If you are referencing to a shortcut like hans@nose.net#1, you will get an error.

 

Last update: 2015-11-09 17:48

.org 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 CORG-<number>, e.g. CORG-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 (@orgcont or @same-as) (.org only)

This means an existing contact handle in the JOKER-DATABASE.

Examples:

owner-contact-handle:CORG-176269
admin-contact-handle:
CORG-176229
tech-contact-handle:
CORG-176269
billing-contact-handle:
CORG-176269

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 .org-requests the contact handles for (.com/.net)-contacts are not allowed. If you are referencing to a shortcut like hans@nose.net#1, you will get an error.

Last update: 2015-11-09 17:49

.info 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 C<number>-LRMS, e.g. C176269-LRMS.

 

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 (@infocont or @same-as) (.info only)

This means an existing contact handle in the JOKER-DATABASE.

Examples:

owner-contact-handle:C176269-LRMS
admin-contact-handle:CAFI-007
tech-contact-handle:C176269-LRMS
billing-contact-handle:CAFI-008

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 .info-requests the contact handles for (.com/.net)-contacts are not allowed. If you are referencing to a shortcut like hans@nose.net#1, you will get an error.

Last update: 2015-11-09 17:49

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

 

ATTENTION

According to the rules of NEULEVEL, the fieldlength for most of the requestfields are limited to 30 characters. Please check very carefully the definitions of the request fields.

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.

Please, keep in mind, that if you are using the concatenation of fname and lname, you have to care that the sum of both fields should not be longer than 30 characters.

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,30} no, if name is given
".."-fname [\x20-\x7e]{0,30} no, if name is given
".."-name [\x20-\x7e]{0,30} yes, if fname and/or lname are not given
".."-title [\x20-\x7e]{0,30} no
".."-organization [\x20-\x7e]{0,30} yes, if individual = N
".."-address-1 [\x20-\x7e]{1,30} yes
".."-address-2 [\x20-\x7e]{0,30} no
".."-address-3 [\x20-\x7e]{0,30} no
".."-postal-code [\x20-\x7e]{1,10} yes
".."-city [\x20-\x7e]{1,30} yes
".."-state [\x20-\x7e]{0,30} no
".."-country @country yes
".."-email @email yes
".."-phone [[\x20-\x7e]{1,17} yes
".."-fax [[\x20-\x7e]{0,17} no

 


An existing contact (@bizcont or @same-as) (.biz only)

This means an existing contact handle in the JOKER-DATABASE.

Examples:

owner-contact-handle: CNEU
-12345
admin-contact-handle:
CNEU-12345
tech-contact-handle: CNEU-12345
billing-contact-handle: CNEU-12345

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 .biz-requests the contact handles for (.com/.net/.org/.info)-contacts are not allowed. If you are referencing to a shortcut like hans@nose.net#1, you will get an error.

Note that for .biz-requests the contacthandles for (.info)-contacts are not allowed. If you referencing to a shortcut like C176269-LRMS, you will get an error.

 

Last update: 2015-11-09 17:51

.mobi 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 COMO-<number>, e.g. COMO-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 (@mobicont or @same-as) (.mobi only)

This means an existing contact handle in the JOKER-DATABASE.

Examples:

owner-contact-handle:COMO-176269
admin-contact-handle:COMO-176229
tech-contact-handle:COMO-176269
billing-contact-handle:COMO-176269

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 .mobi-requests the contact handles for (.com/.net)-contacts are not allowed. If you are referencing to a shortcut like hans@nose.net#1, you will get an error.

 

Last update: 2015-11-09 17:50

.name 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 CNAM-<number>, e.g. CNAM-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 and 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 (@namecont or @same-as) (.name only)

This means an existing contact handle in the JOKER-DATABASE.

Examples:

owner-contact-handle:CNAM-176269
admin-contact-handle:
CNAM-176229
tech-contact-handle:
CNAM-176269
billing-contact-handle:
CNAM-176269

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 .name-requests the contact handles for (.com/.net)-contacts are not allowed. If you are referencing to a shortcut like hans@nose.net#1, you will get an error.

Last update: 2007-06-21 11:11

.us 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 COUS-<number>, e.g. COUS-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 (@uscont or @same-as) (.us only)

This means an existing contact handle in the JOKER-DATABASE.

Examples:

owner-contact-handle:COUS-176269
admin-contact-handle:COUS-176229
tech-contact-handle:COUS-176269
billing-contact-handle:COUS-176269

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 .us-requests the contact handles for (.com/.net)-contacts are not allowed. If you are referencing to a shortcut like hans@nose.net#1, you will get an error.

 

 

Last update: 2015-11-09 17:51

.de 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 CODE-<number>, e.g. CODE-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} yes, but for admin-c and tech-c only
 


An existing contact (@decont or @same-as) (.de only)

This means an existing contact handle in the JOKER-DATABASE.

Examples:

owner-contact-handle:CODE-176269
admin-contact-handle:CODE-176229
tech-contact-handle:CODE-176269
billing-contact-handle:CODE-176269

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 .de-requests the contact handles for (.com/.net/.org/.info/.biz/.cn)-contacts are not allowed. If you are referencing to a shortcut like hans@nose.net#1, you will get an error.

Last update: 2015-11-09 17:50

.cn 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 COCN-<number>, e.g. COCN-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 (@cncont or @same-as) (.cn only)

This means an existing contact handle in the JOKER-DATABASE.

Examples:

owner-contact-handle:COCN-176269
admin-contact-handle:COCN-176229
tech-contact-handle:COCN-176269
billing-contact-handle:COCN-176269

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

Last update: 2015-11-09 17:51

.eu 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 C<number>, e.g. C176269.

 

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 (@uscont or @same-as) (.us only)

This means an existing contact handle in the JOKER-DATABASE.

Examples:

owner-contact-handle:C176269
admin-contact-handle:C176229
tech-contact-handle:C176269
billing-contact-handle:C176269

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 .eu-requests the contact handles for (.com/.net/.org/.info/.biz/.de/.us)-contacts are not allowed. If you are referencing to a shortcut like hans@nose.net#1, you will get an error.

Last update: 2015-11-09 17:52

Valid domain names

@dom - a valid domain name under .com/.net

@orgdom - a valid domain name under .org

@infodom - a valid domain name under .info

@dedom - a valid domain name under .de

@cndom - a valid domain name under .cn

@eudom - a valid domain name under .eu

@usdom - a valid domain name under .us

@fqdn - a valid domain name under .com/.net/.org/.info/.mobi/.name/.biz/.de/.cn/.eu/.us

Last update: 2007-03-28 15:45

Nameserver

@ns - the definition of an existing nameserver

You have to provide a valid nameserver handle. Implicit nameserver creation is not allowed.

Examples:

ns1.foo.bar.net
ns2.foo.bar.net

ns3.foo.bar.net

Last update: 2015-11-09 17:53

Zonefile entries

@a_record

[a hostprefix without the domainname]:[IP-Address]

Example1:

a:www:194.233.101.99

Example2:

a:@:194.233.101.99

@mx_record

[a hostprefix without the domainname]:[priority]:[a full qualified hostname]

Example 1:

mx:www:50:mail.hansnose.net

Example 2:

mx:www:90:mail.hansnose.net

Example 3:

mx:@:50:mail.hansnose.net

Example 4:

mx:@:90:mail.hansnose.net


@cname_record

[a hostprefix without the domainname]:[a full qualified hostname]


Example 1:

cname:www:mail.hansnose.net

Example 2:

cname:www2:mail.hansnose.net


@url_record

[a hostprefix without the domainname]::[a full qualified hostname]

Example 1:

url:www:http://some.redirector.com

Example 2:

url:www2:http://some.redirector.com:9002

Example 3:

url:www3:https://some.redirector.com

Example 4:

url:www4:https://some.redirector.com:9002

Last update: 2007-04-20 14:49

IP

@ip - a valid ip-address

IP-addresses within the following range are NOT valid:

Â

from to
10.0.0.0 10.255.255.255
127.0.0.0 127.255.255.255
192.168.0.0 192.168.255.255
172.16.0.0 172.31.255.255

Last update: 2007-04-02 16:24

Domain renewal

@renew

Here you have to provide the domain name and the renewal period or the desired expiration year on one line. You have to seperate the domain name and renewal period/expire year with an ":" (ASCII 058). The maximum for the renewal period is 9 years.

Examples:

domain1:blafasel.com:2
domain2:hansnose.net:3
domain2:hansnose.info:2005
domain2:hansnose.biz:2

Attention:

If you are using the expire year and the current expire year of the domain is equal or greater than the provided value for that field, the request will not processed.

Last update: 2007-03-28 16:12

Country code

@country - one of the following countries:

Countrycode Country
AF AFGHANISTAN
AL ALBANIA
DZ ALGERIA
AS AMERICAN SAMOA
AD ANDORRA
AO ANGOLA
AI ANGUILLA
AQ ANTARCTICA
AG ANTIGUA AND BARBUDA
AR ARGENTINA
AM ARMENIA
AW ARUBA
AU AUSTRALIA
AT AUSTRIA
AZ AZERBAIJAN
BS BAHAMAS
BH BAHRAIN
BD BANGLADESH
BB BARBADOS
BY BELARUS
BE BELGIUM
BZ BELIZE
BJ BENIN
BM BERMUDA
BT BHUTAN
BO BOLIVIA
BA BOSNIA AND HERZEGOVINA
BW BOTSWANA
BV BOUVET ISLAND
BR BRAZIL
IO BRITISH INDIAN OCEAN TERRITORY
BN BRUNEI DARUSSALAM
BG BULGARIA
BF BURKINA FASO
BI BURUNDI
KH CAMBODIA
CM CAMEROON
CA CANADA
CV CAPE VERDE
KY CAYMAN ISLANDS
CF CENTRAL AFRICAN REPUBLIC
TD CHAD
CL CHILE
CN CHINA
CX CHRISTMAS ISLAND
CC COCOS (KEELING) ISLANDS
CO COLOMBIA
KM COMOROS
CG CONGO
CD CONGO, THE DEMOCRATIC REPUBLIC OF THE
CK COOK ISLANDS
CR COSTA RICA
CI COTE D’IVOIRE
HR CROATIA
CU CUBA
CY CYPRUS
CZ CZECH REPUBLIC
DK DENMARK
DJ DJIBOUTI
DM DOMINICA
DO DOMINICAN REPUBLIC
TP TIMOR
EC ECUADOR
EG EGYPT
SV EL SALVADOR
GQ EQUATORIAL GUINEA
ER ERITREA
EE ESTONIA
ET ETHIOPIA
FK FALKLAND ISLANDS (MALVINAS)
FO FAROE ISLANDS
FJ FIJI
FI FINLAND
FR FRANCE
FX METROPOLITAN
GF FRENCH GUIANA
PF FRENCH POLYNESIA
TF FRENCH SOUTHERN TERRITORIES
GA GABON
GM GAMBIA
GE GEORGIA
DE GERMANY
GH GHANA
GI GIBRALTAR
GR GREECE
GL GREENLAND
GD GRENADA
GP GUADELOUPE
GU GUAM
GT GUATEMALA
GN GUINEA
GW BISSAU
GY GUYANA
HT HAITI
HM HEARD ISLAND AND MCDONALD ISLANDS
VA HOLY SEE (VATICAN CITY STATE)
HN HONDURAS
HK HONG KONG
HU HUNGARY
IS ICELAND
IN INDIA
ID INDONESIA
IR IRAN, ISLAMIC REPUBLIC OF
IQ IRAQ
IE IRELAND
IL ISRAEL
IT ITALY
JM JAMAICA
JP JAPAN
JO JORDAN
KZ KAZAKHSTAN
KE KENYA
KI KIRIBATI
KP KOREA, DEMOCRATIC PEOPLE’S REPUBLIC OF
KR KOREA, REPUBLIC OF
KW KUWAIT
KG KYRGYZSTAN
LA LAO PEOPLE’S DEMOCRATIC REPUBLIC
LV LATVIA
LB LEBANON
LS LESOTHO
LR LIBERIA
LY LIBYAN ARAB JAMAHIRIYA
LI LIECHTENSTEIN
LT LITHUANIA
LU LUXEMBOURG
MO MACAU
MK MACEDONIA, THE FORMER YUGOSLAV REPUBLIC OF
MG MADAGASCAR
MW MALAWI
MY MALAYSIA
MV MALDIVES
ML MALI
MT MALTA
MH MARSHALL ISLANDS
MQ MARTINIQUE
MR MAURITANIA
MU MAURITIUS
YT MAYOTTE
MX MEXICO
FM MICRONESIA, FEDERATED STATES OF
MD MOLDOVA, REPUBLIC OF
MC MONACO
MN MONGOLIA
MS MONTSERRAT
MA MOROCCO
MZ MOZAMBIQUE
MM MYANMAR
NA NAMIBIA
NR NAURU
NP NEPAL
NL NETHERLANDS
AN NETHERLANDS ANTILLES
NC NEW CALEDONIA
NZ NEW ZEALAND
NI NICARAGUA
NE NIGER
NG NIGERIA
NU NIUE
NF NORFOLK ISLAND
MP NORTHERN MARIANA ISLANDS
NO NORWAY
OM OMAN
PK PAKISTAN
PW PALAU
PA PANAMA
PG PAPUA NEW GUINEA
PY PARAGUAY
PE PERU
PH PHILIPPINES
PN PITCAIRN
PL POLAND
PT PORTUGAL
PR RICO
QA QATAR
RE REUNION
RO ROMANIA
RU RUSSIAN FEDERATION
RW RWANDA
KN SAINT KITTS AND NEVIS
LC SAINT LUCIA
VC SAINT VINCENT AND THE GRENADINES
WS SAMOA
SM SAN MARINO
ST SAO TOME AND PRINCIPE
SA SAUDI ARABIA
SN SENEGAL
SC SEYCHELLES
SL LEONE
SG SINGAPORE
SK SLOVAKIA
SI SLOVENIA
SB SOLOMON ISLANDS
SO SOMALIA
ZA AFRICA
GS SOUTH GEORGIA AND THE SOUTH SANDWICH ISLANDS
ES SPAIN
LK SRI LANKA
SH SAINT HELENA
PM SAINT PIERRE AND MIQUELON
SD SUDAN
SR SURINAME
SJ SVALBARD AND JAN MAYEN
SZ SWAZILAND
SE SWEDEN
CH SWITZERLAND
SY SYRIAN ARAB REPUBLIC
TW TAIWAN, PROVINCE OF CHINA
TJ TAJIKISTAN
TZ TANZANIA, UNITED REPUBLIC OF
TH THAILAND
TG TOGO
TK TOKELAU
TO TONGA
TT TRINIDAD AND TOBAGO
TN TUNISIA
TR TURKEY
TM TURKMENISTAN
TC TURKS AND CAICOS ISLANDS
TV TUVALU
UG UGANDA
UA UKRAINE
AE UNITED ARAB EMIRATES
GB UNITED KINGDOM
US UNITED STATES
UM UNITED STATES MINOR OUTLYING ISLANDS
UY URUGUAY
UZ UZBEKISTAN
VU VANUATU
VE VENEZUELA
VN VIETNAM
VG VIRGIN ISLANDS, BRITISH
VI VIRGIN ISLANDS, U.S.
WF WALLIS AND FUTUNA
EH SAHARA
YE YEMEN
YU YUGOSLAVIA
ZM ZAMBIA
ZW ZIMBABWE

Last update: 2007-04-17 22:12

Language code

@language - one of the following language codes

Languagecode Language
AFR Afrikaans
ALB Albanian
ARA Arabic
ARM Armenian
AZE Azerbaijani
BAQ Basque
BUL Bulgarian
BUR Burmese
CAT Catalan
CHI Chinese
CZE Czech
DAN Danish
DUT Dutch
ENG English
EST Estonian
FAO Faroese
FIN Finnish
FRE French
GEO Georgian
GER German
HEB Hebrew
HIN Hindi
HUN Hungarian
ICE Icelandic
ITA Italian
JPN Japanese
KOR Korean
KUR Kurdish
LAO Lao
LAV Latvian
LIT Lithuanian
MAC Macedonian
MAL Malayalm
NEP Nepali
NOR Norwegian
PER Persian
POL Polish
POR Portuguese
RUM Romanian
RUS Russian
SAN Sanskirt
SCC Serbian
SCR Croatian
SLO Slovak
SLV Slovenian
SPA Spanish
SWA Swahili
SWE Swedish
SYR Syriac
TAM Tamil
THA Thai
TIB Tibetan
TUR Turkish
UKR Ukrainian
URD Urdu
UZB Uzbek
VIE Vietnamese
ZHO Chinese

Last update: 2015-11-09 17:46

.me 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 COME-<number>, e.g. COME-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 (@mecont or @same-as) (.me only)

This means an existing contact handle in the JOKER-DATABASE.

Examples:

owner-contact-handle:COME-176269
admin-contact-handle:COME-176229
tech-contact-handle:COME-176269
billing-contact-handle:COME-176269

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

Last update: 2008-08-14 11:46

2. Reseller Docs >> 2.3 Email Gateway >> Requests >> DNS/URL-Forwarding

Create a dns-configuration

Introduction

With this request you can create or modify a zonefile at the joker-nameserver.

You can add A-Records, CNAME-Records, MX-Records, a nameservice-based Url-forwarding and a frame-based Url-forwarding. Modifing the TTL is not possible.

The format of this request is a little bit different from the other requests. Please check the given examples for how to specify the different zonefile-records.

ATTENTION:

You have to change the nameservers for a domain to the nameservers of joker.com first!

- a.ns.joker.com
- b.ns.joker.com
- c.ns.joker.com

If you would like to use the joker-nameservice, you will have to use all joker-nameservers.

It is not possible to use the joker-nameservice

All joker-nameservers

Request Fields

Definition of this request

request-field valid values required
domains0 @fqdn yes
A @a_record no
CNAME @cname_record no
MX @mx_record no
URL @url_record no
FRAME @url_record no


Example 1: create dns-config (without url-forwarding and without wildcard-matching)


subject: create dns-config [your reference id]

domains0:hansnose.net

A:www:194.33.110.19

A:mail:194.33.110.19

A:mail2:194.33.110.20

A:@:194.33.110.10

MX:www.hansnose.net:70:mail.nrw.net

MX:www.hansnose.net:80:mail2.nrw.net

MX:@:70:mail.hansnose.net

MX:@:80:mail2.hansnose.net

CNAME:www3:some.other.domain.com

Example 2: create dns-config (with wildcard-matching)

subject: create dns-config [your reference id]

domains0:hansnose.net

A:www:194.33.110.19

A:@:194.33.110.19

A:*:194.33.110.20

Example 3: create dns-config (with dns-based url-forwarding)

subject: create dns-config [your reference id]

domains0:hansnose.net

A:www:194.33.110.19

A:@:194.33.110.19

URL:www2:http://www.sone.other.domain.com/index.html


(that means, the url within the browserbar is changing to the target address)

Example 4: create dns-config (with frame-based url-forwarding)

subject: create dns-config [your reference id]

domains0:hansnose.net

A:www:194.33.110.19

A:@:194.33.110.19

FRAME:www2:http://www.sone.other.domain.com/index.html


(that means, the url within the browserbar is not changing to the target address)

Last update: 2011-08-11 15:37

Delete a dns-configuration

Introduction

With this request you can delete a zonefile at the joker-nameserver.

Request fields

mailsubject: delete dns-config [your reference id]

Definition of this request

request-field valid values required
domains0 @fqdn yes

Example 1: delete dns-config

subject: delete dns-config [your reference id]

domains0:hansnose.net

Last update: 2011-08-11 15:37

List a dns-configuration

Introduction

With this request you can get a listing of a current zonefile.

Request fields

mailsubject: list dns-config [your reference id] definition of this request
 

request-field valid values required
domains0 @fqdn yes


Example 1: list dns-config

subject: list dns-config [your reference id]

domains0:hansnose.net

Last update: 2011-08-11 15:38

2. Reseller Docs >> 2.3 Email Gateway >> Requests >> Domains

Create an order

Introduction

create <tld>-order

Valid values for <tld>: 

 

With this request you can register one or more domains.

You have to provide the following information within the request:


You can register up to 501 domains with one request.

If you register more than one domain with a request, all domains registerd with this request will have the same contact and nameserver structure.

There are two new requestfields within this request:

 

ATTENTION

Please, refer to the table for the corresponding contact handles.

TLD Contact 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>
me COME-<number>
asia COAS-<number>
xxx CONX-<number>


Request fields

mailsubject: create <tld>-order [your reference id]

Definition of this request

 

tld request field
domains[0..500] period
language[0..500]
com [a-z0-9-]{1,63}\.com ^([1..9]{1})$
@language

net [a-z0-9-]{1,63}\.net ^([1..9]{1})$
org [a-z0-9-]{1,63}\.org ^([1..9]{1})$
info [a-z0-9-]{1,63}\.info ^([1..9]{1})$
biz [a-z0-9][a-z0-9-]{1,61}[a-z0-9]\.biz ^([1..9]{1})$
mobi [a-z0-9-]{1,63}\.mobi ^([1..9]{1})$
name [a-z0-9-]{1,63}\.name ^([2..9]{1})$
us [a-z0-9-]{1,63}\.us ^([2..9]{1})$
de [a-z0-9-]{1,63}\.de ^([1..9]{1})$
cn [a-z0-9][a-z0-9-]{1,61}[a-z0-9]\.cn ^([1..9]{1})$
eu [a-z0-9][a-z0-9-]{1,61}[a-z0-9]\.eu ^([1..9]{1})$
me [a-z0-9][a-z0-9-]{1,61}[a-z0-9]\.me ^([1..9]{1})$
asia [a-z0-9][a-z0-9-]{1,61}[a-z0-9]\.asia ^([1..9]{1})$
xxx [a-z0-9][a-z0-9-]{1,61}[a-z0-9]\.xxx ^([1..9]{1})$
required yes yes no (IDN domains only)



tld owner-contact-handle admin-contact-handle
tech-contact-handle billing-contact-handle
com @comcont
net @netcont
org @orgcont
info @infocont
biz @decont
mobi @mobicont
name @namecont
us @uscont
de @bizcont
cn @cncont
eu @eucont
me
 @mecont
asia  @asiacon
required yes



tld ns1-handle ns1-handle
ns1-handle ns1-handle
ns1-handle
ns1-handle
<tld> @ns
required yes yes no

 

 

.COM order

 

Example 1: create com-order with implicit contact-handle-creation of the owner-contact

subject: create com-order [your reference id]

domains0:xn--hans-mller-feb.com
language0:AFR
domains1:minus-10a.com
domains2:minus-10b.com
domains3:minus-10c.com
domains4:minus-10d.com
domains5:minus-10e.com
period:2
owner-contact-email:gonzo@nose.net
owner-contact-individual:Y
owner-contact-fname:gonzo
owner-contact-lname:nose
owner-contact-address-1:horsefair mews
owner-contact-postal-code:4711
owner-contact-city:romsey
owner-contact-country:DE
owner-contact-phone:44 13383794 504040
admin-contact-handle:same-as-owner-contact
tech-contact-handle:same-as-admin-contact
billing-contact-handle:CCOM-123
ns1-handle:ns.gonzo.net
ns2-handle:ns2.gonzo.net

 

Example 2: create com-order with implicit nameserver-creation

subject: create com-order [your reference id]

domains0:minus-109.com
domains1:minus-10a.com
domains2:minus-10b.com
domains3:minus-10c.com
domains4:minus-10d.com
domains5:minus-10e.com
period:2
owner-contact-handle:CCOM-123
admin-contact-handle:same-as-owner-contact
tech-contact-handle:same-as-admin-contact
billing-contact-handle:CCOM-13323
ns1-domain-name:nsxx1.gonzo.net
ns1-ip-address:194.201.101.1
ns2-domain-name:nsxx1.gonzo.net
ns2-ip-address:194.201.101.2


Example 3: create com-order with implicit contact-handle-creation of all contacts

subject: create com-order [your reference id]

domains0:minus-109.com
domains1:minus-10a.com
domains2:minus-10b.com
domains3:minus-10c.com
domains4:minus-10d.com
domains5:minus-10e.com
period:2
owner-contact-email:hans@nose.net
owner-contact-individual:Y
owner-contact-lname:nose
owner-contact-fname:hans
owner-contact-address-1:horsefair mews
owner-contact-city:romsey
owner-contact-postal-code:4711
owner-contact-country:DE
owner-contact-phone:44 13383794 504040
admin-contact-email:gonzo@nose.net
admin-contact-individual:Y
admin-contact-fname:gonzo
admin-contact-lname:nose
admin-contact-address-1:horsefair mews
admin-contact-city:romsey
admin-contact-postal-code:4711
admin-contact-country:DE
admin-contact-phone:44 13383794 504040
tech-contact-email:willi@nose.net
tech-contact-individual:Y
tech-contact-fname:willi
tech-contact-lname:nose
tech-contact-address-1:horsefair mews
tech-contact-city:romsey
tech-contact-postal-code:4711
tech-contact-country:DE
tech-contact-phone:44 13383794 504040
billing-contact-email:isp@greatone.net
billing-contact-individual:Y
billing-contact-fname:gonzo
billing-contact-lname:nose
billing-contact-address-1:Melrose Plase
billing-contact-postal-code:4711
billing-contact-city:romsey
billing-contact-country:DE
billing-contact-phone:44 13383794 504040
ns1-domain-name:nsxx1.gonzo.net
ns1-ip-address:194.201.101.1
ns2-domain-name:nsxx1.gonzo.net
ns2-ip-address:194.201.101.2


 

.NET order

 

Example 1: create net-order with implicit contact-handle-creation of the owner-contact

subject: create net-order [your reference id]

domains0:xn--hans-mller-feb.net
language0:AFR
domains1:minus-10a.net
domains2:minus-10b.net
domains3:minus-10c.net
domains4:minus-10d.net
domains5:minus-10e.net
period:2
owner-contact-email:gonzo@nose.net
owner-contact-individual:Y
owner-contact-fname:gonzo
owner-contact-lname:nose
owner-contact-address-1:horsefair mews
owner-contact-postal-code:4711
owner-contact-city:romsey
owner-contact-country:DE
owner-contact-phone:44 13383794 504040
admin-contact-handle:same-as-owner-contact
tech-contact-handle:same-as-admin-contact
billing-contact-handle:CCOM-123
ns1-handle:ns.gonzo.net
ns2-handle:ns2.gonzo.net


Example 2: create net-order with implicit nameserver-creation

subject: create net-order [your reference id]

domains0:minus-109.net
domains1:minus-10a.net
domains2:minus-10b.net
domains3:minus-10c.net
domains4:minus-10d.net
domains5:minus-10e.net
period:2
owner-contact-handle:CCOM-123
admin-contact-handle:same-as-owner-contact
tech-contact-handle:same-as-admin-contact
billing-contact-handle:CCOM-13323
ns1-domain-name:nsxx1.gonzo.net
ns1-ip-address:194.201.101.1
ns2-domain-name:nsxx1.gonzo.net
ns2-ip-address:194.201.101.2


Example 3: create net-order with implicit contact-handle-creation of all contacts

subject: create net-order [your reference id]

domains0:minus-109.net
domains1:minus-10a.net
domains2:minus-10b.net
domains3:minus-10c.net
domains4:minus-10d.net
domains5:minus-10e.net
period:2
owner-contact-email:hans@nose.net
owner-contact-individual:Y
owner-contact-lname:nose
owner-contact-fname:hans
owner-contact-address-1:horsefair mews
owner-contact-city:romsey
owner-contact-postal-code:4711
owner-contact-country:DE
owner-contact-phone:44 13383794 504040
admin-contact-email:gonzo@nose.net
admin-contact-individual:Y
admin-contact-fname:gonzo
admin-contact-lname:nose
admin-contact-address-1:horsefair mews
admin-contact-city:romsey
admin-contact-postal-code:4711
admin-contact-country:DE
admin-contact-phone:44 13383794 504040
tech-contact-email:willi@nose.net
tech-contact-individual:Y
tech-contact-fname:willi
tech-contact-lname:nose
tech-contact-address-1:horsefair mews
tech-contact-city:romsey
tech-contact-postal-code:4711
tech-contact-country:DE
tech-contact-phone:44 13383794 504040
billing-contact-email:isp@greatone.net
billing-contact-individual:Y
billing-contact-fname:gonzo
billing-contact-lname:nose
billing-contact-address-1:Melrose Plase
billing-contact-postal-code:4711
billing-contact-city:romsey
billing-contact-country:DE
billing-contact-phone:44 13383794 504040
ns1-domain-name:nsxx1.gonzo.net
ns1-ip-address:194.201.101.1
ns2-domain-name:nsxx1.gonzo.net
ns2-ip-address:194.201.101.2

 

 

.ORG order

 

Example 1: create org-order with implicit contact-handle-creation of the owner-contact

subject: create org-order [your reference id]

domains0:xn--hans-mller-feb.org
language0:AFR
domains1:minus-10a.org
domains2:minus-10b.org
domains3:minus-10c.org
domains4:minus-10d.org
domains5:minus-10e.org
period:2
owner-contact-email:gonzo@nose.net
owner-contact-individual:Y
owner-contact-fname:gonzo
owner-contact-lname:nose
owner-contact-address-1:horsefair mews
owner-contact-postal-code:4711
owner-contact-city:romsey
owner-contact-country:DE
owner-contact-phone:44 13383794 504040
admin-contact-handle:same-as-owner-contact
tech-contact-handle:same-as-admin-contact
billing-contact-handle:CORG-123
ns1-handle:ns.gonzo.net
ns2-handle:ns2.gonzo.net


Example 2: create org-order with implicit nameserver-creation

subject: create org-order [your reference id]

domains0:minus-109.org
domains1:minus-10a.org
domains2:minus-10b.org
domains3:minus-10c.org
domains4:minus-10d.org
domains5:minus-10e.org
period:2
owner-contact-handle:CORG-123
admin-contact-handle:same-as-owner-contact
tech-contact-handle:same-as-admin-contact
billing-contact-handle:CORG-13323
ns1-domain-name:nsxx1.gonzo.net
ns1-ip-address:194.201.101.1
ns2-domain-name:nsxx1.gonzo.net
ns2-ip-address:194.201.101.2


Example 3: create org-order with implicit contact-handle-creation of all contacts

subject: create org-order [your reference id]

domains0:minus-109.org
domains1:minus-10a.org
domains2:minus-10b.org
domains3:minus-10c.org
domains4:minus-10d.org
domains5:minus-10e.org
period:2
owner-contact-email:hans@nose.net
owner-contact-individual:Y
owner-contact-lname:nose
owner-contact-fname:hans
owner-contact-address-1:horsefair mews
owner-contact-city:romsey
owner-contact-postal-code:4711
owner-contact-country:DE
owner-contact-phone:44 13383794 504040
admin-contact-email:gonzo@nose.net
admin-contact-individual:Y
admin-contact-fname:gonzo
admin-contact-lname:nose
admin-contact-address-1:horsefair mews
admin-contact-city:romsey
admin-contact-postal-code:4711
admin-contact-country:DE
admin-contact-phone:44 13383794 504040
tech-contact-email:willi@nose.net
tech-contact-individual:Y
tech-contact-fname:willi
tech-contact-lname:nose
tech-contact-address-1:horsefair mews
tech-contact-city:romsey
tech-contact-postal-code:4711
tech-contact-country:DE
tech-contact-phone:44 13383794 504040
billing-contact-email:isp@greatone.net
billing-contact-individual:Y
billing-contact-fname:gonzo
billing-contact-lname:nose
billing-contact-address-1:Melrose Plase
billing-contact-postal-code:4711
billing-contact-city:romsey
billing-contact-country:DE
billing-contact-phone:44 13383794 504040
ns1-domain-name:nsxx1.gonzo.net
ns1-ip-address:194.201.101.1
ns2-domain-name:nsxx1.gonzo.net
ns2-ip-address:194.201.101.2

 

.INFO order

 

Example 1: create info-order with implicit contact-handle-creation of the owner-contact

subject: create info-order [your reference id]

domains0:xn--hans-mller-feb.info
language0:AFR
domains1:minus-10a.info
domains2:minus-10b.info
domains3:minus-10c.info
domains4:minus-10d.info
domains5:minus-10e.info
period:2
owner-contact-email:gonzo@nose.net
owner-contact-individual:Y
owner-contact-fname:gonzo
owner-contact-lname:nose
owner-contact-address-1:horsefair mews
owner-contact-postal-code:4711
owner-contact-city:romsey
owner-contact-country:DE
owner-contact-phone:44 13383794 504040
admin-contact-handle:same-as-owner-contact
tech-contact-handle:same-as-admin-contact
billing-contact-handle:C282828-LRMS
ns1-handle:ns.gonzo.net
ns2-handle:ns2.gonzo.net


Example 2: create info-order with implicit nameserver-creation

subject: create info-order [your reference id]

domains0:minus-109.info
domains1:minus-10a.info
domains2:minus-10b.info
domains3:minus-10c.info
domains4:minus-10d.info
domains5:minus-10e.info
period:2
owner-contact-handle:C176269-LRMS
admin-contact-handle:same-as-owner-contact
tech-contact-handle:same-as-admin-contact
billing-contact-handle:C176219-LRMS
ns1-domain-name:nsxx1.gonzo.net
ns1-ip-address:194.201.101.1
ns2-domain-name:nsxx1.gonzo.net
ns2-ip-address:194.201.101.2


Example 3: create info-order with implicit contact-handle-creation of all contacts

subject: create info-order [your reference id]

domains0:minus-109.info
domains1:minus-10a.info
domains2:minus-10b.info
domains3:minus-10c.info
domains4:minus-10d.info
domains5:minus-10e.info
period:2
owner-contact-email:hans@nose.net
owner-contact-individual:Y
owner-contact-lname:nose
owner-contact-fname:hans
owner-contact-address-1:horsefair mews
owner-contact-city:romsey
owner-contact-postal-code:4711
owner-contact-country:DE
owner-contact-phone:44 13383794 504040
admin-contact-email:gonzo@nose.net
admin-contact-individual:Y
admin-contact-fname:gonzo
admin-contact-lname:nose
admin-contact-address-1:horsefair mews
admin-contact-city:romsey
admin-contact-postal-code:4711
admin-contact-country:DE
admin-contact-phone:44 13383794 504040
tech-contact-email:willi@nose.net
tech-contact-individual:Y
tech-contact-fname:willi
tech-contact-lname:nose
tech-contact-address-1:horsefair mews
tech-contact-city:romsey
tech-contact-postal-code:4711
tech-contact-country:DE
tech-contact-phone:44 13383794 504040
billing-contact-email:isp@greatone.net
billing-contact-individual:Y
billing-contact-fname:gonzo
billing-contact-lname:nose
billing-contact-address-1:Melrose Plase
billing-contact-postal-code:4711
billing-contact-city:romsey
billing-contact-country:DE
billing-contact-phone:44 13383794 504040
ns1-domain-name:nsxx1.gonzo.net
ns1-ip-address:194.201.101.1
ns2-domain-name:nsxx1.gonzo.net
ns2-ip-address:194.201.101.2

.BIZ order

 


Example 1: create biz-order with implicit contact-handle-creation of the owner-contact

domains0:xn--hans-mller-feb.biz
language0:AFR
domains1:minus-10a.biz
domains2:minus-10b.biz
domains3:minus-10c.biz
domains4:minus-10d.biz
domains5:minus-10e.biz
period:2
owner-contact-email:hans@nose.net
owner-contact-individual:Y
owner-contact-lname:nose
owner-contact-fname:hans
owner-contact-address-1:horsefair mews
owner-contact-city:romsey
owner-contact-postal-code:4711
owner-contact-country:DE
owner-contact-phone:44 13383794 504040
admin-contact-email:gonzo@nose.net
admin-contact-individual:Y
admin-contact-fname:gonzo
admin-contact-lname:nose
admin-contact-address-1:horsefair mews
admin-contact-city:romsey
admin-contact-postal-code:4711
admin-contact-country:DE
admin-contact-phone:44 13383794 504040
tech-contact-email:willi@nose.net
tech-contact-individual:Y
tech-contact-fname:willi
tech-contact-lname:nose
tech-contact-address-1:horsefair mews
tech-contact-city:romsey
tech-contact-postal-code:4711
tech-contact-country:DE
tech-contact-phone:44 13383794 504040
billing-contact-email:isp@greatone.net
billing-contact-individual:Y
billing-contact-fname:gonzo
billing-contact-lname:nose
billing-contact-address-1:Melrose Plase
billing-contact-postal-code:4711
billing-contact-city:romsey
billing-contact-country:DE
billing-contact-phone:44 13383794 504040
ns1-domain-name:nsxx1.gonzo.net
ns1-ip-address:194.201.101.1
ns2-domain-name:nsxx1.gonzo.net
ns2-ip-address:194.201.101.2


Example 2: create biz-order with implicit nameserver-creation

subject: create biz-order [your reference id]

domains0:minus-109.biz
domains1:minus-10a.biz
domains2:minus-10b.biz
domains3:minus-10c.biz
domains4:minus-10d.biz
domains5:minus-10e.biz
period:2
owner-contact-handle:CNEU-123
admin-contact-handle:CNEU-124
tech-contact-handle:CNEU-125
billing-contact-handle:CNEU-126
ns1-domain-name:nsxx1.gonzo.net
ns1-ip-address:194.201.101.1
ns2-domain-name:nsxx1.gonzo.net
ns2-ip-address:194.201.101.2


Example 3: create biz-order with implicit contact-handle-creation of all contacts

subject: create biz-order [your reference id]

domains0:minus-109.biz
domains1:minus-10a.biz
domains2:minus-10b.biz
domains3:minus-10c.biz
domains4:minus-10d.biz
domains5:minus-10e.biz
period:2
owner-contact-email:hans@nose.net
owner-contact-individual:Y
owner-contact-lname:nose
owner-contact-fname:hans
owner-contact-address-1:horsefair mews
owner-contact-city:romsey
owner-contact-postal-code:4711
owner-contact-country:DE
owner-contact-phone:44 13383794 504040
admin-contact-email:gonzo@nose.net
admin-contact-individual:Y
admin-contact-fname:gonzo
admin-contact-lname:nose
admin-contact-address-1:horsefair mews
admin-contact-city:romsey
admin-contact-postal-code:4711
admin-contact-country:DE
admin-contact-phone:44 13383794 504040
tech-contact-email:willi@nose.net
tech-contact-individual:Y
tech-contact-fname:willi
tech-contact-lname:nose
tech-contact-address-1:horsefair mews
tech-contact-city:romsey
tech-contact-postal-code:4711
tech-contact-country:DE
tech-contact-phone:44 13383794 504040
billing-contact-email:isp@greatone.net
billing-contact-individual:Y
billing-contact-fname:gonzo
billing-contact-lname:nose
billing-contact-address-1:Melrose Plase
billing-contact-postal-code:4711
billing-contact-city:romsey
billing-contact-country:DE
billing-contact-phone:44 13383794 504040
ns1-domain-name:nsxx1.gonzo.net
ns1-ip-address:194.201.101.1
ns2-domain-name:nsxx1.gonzo.net
ns2-ip-address:194.201.101.2

 

 

.MOBI ORDER


Example 1: create mobi-order with implicit contact-handle-creation of the owner-contact

subject: create mobi-order [your reference id]

domains0:xn--hans-mller-feb.mobi
language0:AFR
domains1:minus-10a.mobi
domains2:minus-10b.mobi
domains3:minus-10c.mobi
domains4:minus-10d.mobi
domains5:minus-10e.mobi
period:2
owner-contact-email:gonzo@nose.net
owner-contact-individual:Y
owner-contact-fname:gonzo
owner-contact-lname:nose
owner-contact-address-1:horsefair mews
owner-contact-postal-code:4711
owner-contact-city:romsey
owner-contact-country:DE
owner-contact-phone:44 13383794 504040
admin-contact-handle:same-as-owner-contact
tech-contact-handle:same-as-admin-contact
billing-contact-handle:COMO-123
ns1-handle:ns.gonzo.net
ns2-handle:ns2.gonzo.net


Example 2: create mobi-order with implicit nameserver-creation

subject: create mobi-order [your reference id]

domains0:minus-109.mobi
domains1:minus-10a.mobi
domains2:minus-10b.mobi
domains3:minus-10c.mobi
domains4:minus-10d.mobi
domains5:minus-10e.mobi
period:2
owner-contact-handle:COMO-123
admin-contact-handle:same-as-owner-contact
tech-contact-handle:same-as-admin-contact
billing-contact-handle:COMO-13323
ns1-domain-name:nsxx1.gonzo.net
ns1-ip-address:194.201.101.1
ns2-domain-name:nsxx1.gonzo.net
ns2-ip-address:194.201.101.2


Example 3: create mobi-order with implicit contact-handle-creation of all contacts

subject: create mobi-order [your reference id]

domains0:minus-109.mobi
domains1:minus-10a.mobi
domains2:minus-10b.mobi
domains3:minus-10c.mobi
domains4:minus-10d.mobi
domains5:minus-10e.mobi
period:2
owner-contact-email:hans@nose.net
owner-contact-individual:Y
owner-contact-lname:nose
owner-contact-fname:hans
owner-contact-address-1:horsefair mews
owner-contact-city:romsey
owner-contact-postal-code:4711
owner-contact-country:DE
owner-contact-phone:44 13383794 504040
admin-contact-email:gonzo@nose.net
admin-contact-individual:Y
admin-contact-fname:gonzo
admin-contact-lname:nose
admin-contact-address-1:horsefair mews
admin-contact-city:romsey
admin-contact-postal-code:4711
admin-contact-country:DE
admin-contact-phone:44 13383794 504040
tech-contact-email:willi@nose.net
tech-contact-individual:Y
tech-contact-fname:willi
tech-contact-lname:nose
tech-contact-address-1:horsefair mews
tech-contact-city:romsey
tech-contact-postal-code:4711
tech-contact-country:DE
tech-contact-phone:44 13383794 504040
billing-contact-email:isp@greatone.net
billing-contact-individual:Y
billing-contact-fname:gonzo
billing-contact-lname:nose
billing-contact-address-1:Melrose Plase
billing-contact-postal-code:4711
billing-contact-city:romsey
billing-contact-country:DE
billing-contact-phone:44 13383794 504040
ns1-domain-name:nsxx1.gonzo.net
ns1-ip-address:194.201.101.1
ns2-domain-name:nsxx1.gonzo.net
ns2-ip-address:194.201.101.2

 

 

.NAME ORDER

 

Example 1: create name-order with implicit contact-handle-creation of the owner-contact

subject: create name-order [your reference id]

domains0:xn--hans-mller-feb.net
language0:AFR
domains1:minus-10a.name
domains2:minus-10b.name
domains3:minus-10c.name
domains4:minus-10d.name
domains5:minus-10e.name
period:2
owner-contact-email:gonzo@nose.net
owner-contact-individual:Y
owner-contact-fname:gonzo
owner-contact-lname:nose
owner-contact-address-1:horsefair mews
owner-contact-postal-code:4711
owner-contact-city:romsey
owner-contact-country:DE
owner-contact-phone:44 13383794 504040
admin-contact-handle:same-as-owner-contact
tech-contact-handle:same-as-admin-contact
billing-contact-handle:CNAM-123
ns1-handle:ns.gonzo.net
ns2-handle:ns2.gonzo.net


Example 2: create name-order with implicit nameserver-creation

subject: create name-order [your reference id]

domains0:minus-109.name
domains1:minus-10a.name
domains2:minus-10b.name
domains3:minus-10c.name
domains4:minus-10d.name
domains5:minus-10e.name
period:2
owner-contact-handle:CNAM-123
admin-contact-handle:same-as-owner-contact
tech-contact-handle:same-as-admin-contact
billing-contact-handle:CNAM-13323
ns1-domain-name:nsxx1.gonzo.net
ns1-ip-address:194.201.101.1
ns2-domain-name:nsxx1.gonzo.net
ns2-ip-address:194.201.101.2


Example 3: create name-order with implicit contact-handle-creation of all contacts

subject: create name-order [your reference id]

domains0:minus-109.name
domains1:minus-10a.name
domains2:minus-10b.name
domains3:minus-10c.name
domains4:minus-10d.name
domains5:minus-10e.name
period:2
owner-contact-email:hans@nose.net
owner-contact-individual:Y
owner-contact-lname:nose
owner-contact-fname:hans
owner-contact-address-1:horsefair mews
owner-contact-city:romsey
owner-contact-postal-code:4711
owner-contact-country:DE
owner-contact-phone:44 13383794 504040
admin-contact-email:gonzo@nose.net
admin-contact-individual:Y
admin-contact-fname:gonzo
admin-contact-lname:nose
admin-contact-address-1:horsefair mews
admin-contact-city:romsey
admin-contact-postal-code:4711
admin-contact-country:DE
admin-contact-phone:44 13383794 504040
tech-contact-email:willi@nose.net
tech-contact-individual:Y
tech-contact-fname:willi
tech-contact-lname:nose
tech-contact-address-1:horsefair mews
tech-contact-city:romsey
tech-contact-postal-code:4711
tech-contact-country:DE
tech-contact-phone:44 13383794 504040
billing-contact-email:isp@greatone.net
billing-contact-individual:Y
billing-contact-fname:gonzo
billing-contact-lname:nose
billing-contact-address-1:Melrose Plase
billing-contact-postal-code:4711
billing-contact-city:romsey
billing-contact-country:DE
billing-contact-phone:44 13383794 504040
ns1-domain-name:nsxx1.gonzo.net
ns1-ip-address:194.201.101.1
ns2-domain-name:nsxx1.gonzo.net
ns2-ip-address:194.201.101.2

 

 

.US ORDER


Example 1: create us-order with implicit contact-handle-creation of the owner-contact

subject: create us-order [your reference id]

domains0:xn--hans-mller-feb.us
language0:AFR
domains1:minus-10a.us
domains2:minus-10b.us
domains3:minus-10c.us
domains4:minus-10d.us
domains5:minus-10e.us
period:2
owner-contact-email:gonzo@nose.net
owner-contact-individual:Y
owner-contact-fname:gonzo
owner-contact-lname:nose
owner-contact-address-1:horsefair mews
owner-contact-postal-code:4711
owner-contact-city:romsey
owner-contact-country:DE
owner-contact-phone:44 13383794 504040
admin-contact-handle:same-as-owner-contact
tech-contact-handle:same-as-admin-contact
billing-contact-handle:COUS-123
ns1-handle:ns.gonzo.net
ns2-handle:ns2.gonzo.net


Example 2: create us-order with implicit nameserver-creation

subject: create us-order [your reference id]

domains0:minus-109.us
domains1:minus-10a.us
domains2:minus-10b.us
domains3:minus-10c.us
domains4:minus-10d.us
domains5:minus-10e.us
period:2
owner-contact-handle:COUS-123
admin-contact-handle:same-as-owner-contact
tech-contact-handle:same-as-admin-contact
billing-contact-handle:COUS-13323
ns1-domain-name:nsxx1.gonzo.net
ns1-ip-address:194.201.101.1
ns2-domain-name:nsxx1.gonzo.net
ns2-ip-address:194.201.101.2


Example 3: create us-order with implicit contact-handle-creation of all contacts

subject: create us-order [your reference id]

domains0:minus-109.us
domains1:minus-10a.us
domains2:minus-10b.us
domains3:minus-10c.us
domains4:minus-10d.us
domains5:minus-10e.us
period:2
owner-contact-email:hans@nose.net
owner-contact-individual:Y
owner-contact-lname:nose
owner-contact-fname:hans
owner-contact-address-1:horsefair mews
owner-contact-city:romsey
owner-contact-postal-code:4711
owner-contact-country:DE
owner-contact-phone:44 13383794 504040
admin-contact-email:gonzo@nose.net
admin-contact-individual:Y
admin-contact-fname:gonzo
admin-contact-lname:nose
admin-contact-address-1:horsefair mews
admin-contact-city:romsey
admin-contact-postal-code:4711
admin-contact-country:DE
admin-contact-phone:44 13383794 504040
tech-contact-email:willi@nose.net
tech-contact-individual:Y
tech-contact-fname:willi
tech-contact-lname:nose
tech-contact-address-1:horsefair mews
tech-contact-city:romsey
tech-contact-postal-code:4711
tech-contact-country:DE
tech-contact-phone:44 13383794 504040
billing-contact-email:isp@greatone.net
billing-contact-individual:Y
billing-contact-fname:gonzo
billing-contact-lname:nose
billing-contact-address-1:Melrose Plase
billing-contact-postal-code:4711
billing-contact-city:romsey
billing-contact-country:DE
billing-contact-phone:44 13383794 504040
ns1-domain-name:nsxx1.gonzo.net
ns1-ip-address:194.201.101.1
ns2-domain-name:nsxx1.gonzo.net
ns2-ip-address:194.201.101.2

 

.DE ORDER


Example 1: create de-order with implicit contact-handle-creation of the owner-contact

subject: create de-order [your reference id]

domains0:minus-10x.de
language0:GER
domains1:minus-10a.de
domains2:minus-10b.de
domains3:minus-10c.de
domains4:minus-10d.de
domains5:minus-10e.de
period:2
owner-contact-email:gonzo@nose.net
owner-contact-individual:Y
owner-contact-fname:gonzo
owner-contact-lname:nase
owner-contact-address-1:Musterstrasse 11
owner-contact-postal-code:4711
owner-contact-city:Musterhausen
owner-contact-country:DE
owner-contact-phone:49 13383794 504040
owner-contact-fax:49 13383794 504040
admin-contact-handle:same-as-owner-contact
tech-contact-handle:same-as-admin-contact
billing-contact-handle:CODE-1007
ns1-handle:ns.gonzo.net
ns2-handle:ns2.gonzo.net


Example 2:
create net-order with implicit nameserver-creation

subject: create de-order [your reference id]

domains0:minus-109.de
domains1:minus-10a.de
domains2:minus-10b.de
domains3:minus-10c.de
domains4:minus-10d.de
domains5:minus-10e.de
period:2
owner-contact-handle:CODE-1007
admin-contact-handle:same-as-owner-contact
tech-contact-handle:same-as-admin-contact
billing-contact-handle:CODE-1007
ns1-domain-name:nsxx1.gonzo.net
ns1-ip-address:194.201.101.1
ns2-domain-name:nsxx1.gonzo.net
ns2-ip-address:194.201.101.2


Example 3: create net-order with implicit contact-handle-creation of all contacts

subject: create de-order [your reference id]

domains0:minus-109.de
domains1:minus-10a.de
domains2:minus-10b.de
domains3:minus-10c.de
domains4:minus-10d.de
domains5:minus-10e.de
period:2
owner-contact-email:gonzo@nose.net
owner-contact-individual:Y
owner-contact-fname:gonzo
owner-contact-lname:nase
owner-contact-address-1:Musterstrasse 11
owner-contact-postal-code:4711
owner-contact-city:Musterhausen
owner-contact-country:DE
owner-contact-phone:49 13383794 504040
owner-contact-fax:49 13383794 504040
admin-contact-email:gonzo@nose.net
admin-contact-individual:Y
admin-contact-fname:gonzo
admin-contact-lname:nase
admin-contact-address-1:Musterstrasse 11
admin-contact-postal-code:4711
admin-contact-city:Musterhausen
admin-contact-country:DE
admin-contact-phone:49 13383794 504040
admin-contact-fax:49 13383794 504040
tech-contact-email:gonzo@nose.net
tech-contact-individual:Y
tech-contact-fname:gonzo
tech-contact-lname:nase
tech-contact-address-1:Musterstrasse 11
tech-contact-postal-code:4711
tech-contact-city:Musterhausen
tech-contact-country:DE
tech-contact-phone:49 13383794 504040
tech-contact-fax:49 13383794 504040
billing-contact-email:gonzo@nose.net
billing-contact-individual:Y
billing-contact-fname:gonzo
billing-contact-lname:nase
billing-contact-address-1:Musterstrasse 11
billing-contact-postal-code:4711
billing-contact-city:Musterhausen
billing-contact-country:DE
billing-contact-phone:49 13383794 504040
billing-contact-fax:49 13383794 504040
ns1-domain-name:nsxx1.gonzo.net
ns1-ip-address:194.201.101.1
ns2-domain-name:nsxx1.gonzo.net
ns2-ip-address:194.201.101.2


.CN ORDER


Example 1: create cn-order with implicit contact-handle-creation of the owner-contact

subject: create cn-order [your reference id]

domains0:xn--hans-mller-feb.cn
domains1:minus-10a.cn
domains2:minus-10b.cn
domains3:minus-10c.cn
domains4:minus-10d.cn
domains5:minus-10e.cn
period:2
owner-contact-email:hans@nose.net
owner-contact-individual:Y
owner-contact-lname:nose
owner-contact-fname:hans
owner-contact-address-1:horsefair mews
owner-contact-city:romsey
owner-contact-postal-code:4711
owner-contact-country:DE
owner-contact-phone:44 13383794 504040
admin-contact-email:gonzo@nose.net
admin-contact-individual:Y
admin-contact-fname:gonzo
admin-contact-lname:nose
admin-contact-address-1:horsefair mews
admin-contact-city:romsey
admin-contact-postal-code:4711
admin-contact-country:DE
admin-contact-phone:44 13383794 504040
tech-contact-email:willi@nose.net
tech-contact-individual:Y
tech-contact-fname:willi
tech-contact-lname:nose
tech-contact-address-1:horsefair mews
tech-contact-city:romsey
tech-contact-postal-code:4711
tech-contact-country:DE
tech-contact-phone:44 13383794 504040
billing-contact-email:isp@greatone.net
billing-contact-individual:Y
billing-contact-fname:gonzo
billing-contact-lname:nose
billing-contact-address-1:Melrose Plase
billing-contact-postal-code:4711
billing-contact-city:romsey
billing-contact-country:DE
billing-contact-phone:44 13383794 504040
ns1-domain-name:nsxx1.gonzo.net
ns1-ip-address:194.201.101.1
ns2-domain-name:nsxx1.gonzo.net
ns2-ip-address:194.201.101.2


Example 2: create cn-order using existing cn-handles

subject: create cn-order [your reference id]

domains0:minus-109.cn
domains1:minus-10a.cn
domains2:minus-10b.cn
domains3:minus-10c.cn
domains4:minus-10d.cn
domains5:minus-10e.cn
period:2
owner-contact-handle:COCN-123
admin-contact-handle:COCN-124
tech-contact-handle:COCN-125
billing-contact-handle:COCN-126
ns1-domain-name:nsxx1.gonzo.net
ns1-ip-address:194.201.101.1
ns2-domain-name:nsxx1.gonzo.net
ns2-ip-address:194.201.101.2


Example 3: create cn-order with backreferences using @same-as

subject: create cn-order [your reference id]

domains0:minus-109.cn
domains1:minus-10a.cn
domains2:minus-10b.cn
domains3:minus-10c.cn
domains4:minus-10d.cn
domains5:minus-10e.cn
period:2
owner-contact-email:hans@nose.net
owner-contact-individual:Y
owner-contact-lname:nose
owner-contact-fname:hans
owner-contact-address-1:horsefair mews
owner-contact-city:romsey
owner-contact-postal-code:4711
owner-contact-country:DE
owner-contact-phone:44 13383794 504040
admin-contact-handle:same-as-owner-contact
tech-contact-handle:same-as-admin-contact
billing-contact-handle:same-as-tech-contact
ns1-domain-name:nsxx1.gonzo.net
ns1-ip-address:194.201.101.1
ns2-domain-name:nsxx1.gonzo.net
ns2-ip-address:194.201.101.2

 

.EU ORDER


Example 1: create eu-order with implicit contact-handle-creation of all contacts

subject: create eu-order [your reference id]

domains0:xn--hans-mller-feb.eu
domains1:minus-10a.eu
domains2:minus-10b.eu
domains3:minus-10c.eu
domains4:minus-10d.eu
domains5:minus-10e.eu
period:2
owner-contact-email:hans@nose.net
owner-contact-individual:Y
owner-contact-lname:nose
owner-contact-fname:hans
owner-contact-address-1:horsefair mews
owner-contact-city:romsey
owner-contact-postal-code:4711
owner-contact-country:DE
owner-contact-phone:44 13383794 504040
admin-contact-email:gonzo@nose.net
admin-contact-individual:Y
admin-contact-fname:gonzo
admin-contact-lname:nose
admin-contact-address-1:horsefair mews
admin-contact-city:romsey
admin-contact-postal-code:4711
admin-contact-country:DE
admin-contact-phone:44 13383794 504040
tech-contact-email:willi@nose.net
tech-contact-individual:Y
tech-contact-fname:willi
tech-contact-lname:nose
tech-contact-address-1:horsefair mews
tech-contact-city:romsey
tech-contact-postal-code:4711
tech-contact-country:DE
tech-contact-phone:44 13383794 504040
billing-contact-email:isp@greatone.net
billing-contact-individual:Y
billing-contact-fname:gonzo
billing-contact-lname:nose
billing-contact-address-1:Melrose Plase
billing-contact-postal-code:4711
billing-contact-city:romsey
billing-contact-country:DE
billing-contact-phone:44 13383794 504040
ns1-domain-name:nsxx1.gonzo.net
ns1-ip-address:194.201.101.1
ns2-domain-name:nsxx1.gonzo.net
ns2-ip-address:194.201.101.2


Example 2: create eu-order using existing .eu-handles

subject: create eu-order [your reference id]

domains0:minus-109.eu
domains1:minus-10a.eu
domains2:minus-10b.eu
domains3:minus-10c.eu
domains4:minus-10d.eu
domains5:minus-10e.eu
period:2
owner-contact-handle:C123123
admin-contact-handle:C123124
tech-contact-handle:C123125
billing-contact-handle:C123126
ns1-domain-name:nsxx1.gonzo.net
ns1-ip-address:194.201.101.1
ns2-domain-name:nsxx1.gonzo.net
ns2-ip-address:194.201.101.2


Example 3: create eu-order with backreferences using @same-as

subject: create eu-order [your reference id]

domains0:minus-109.eu
domains1:minus-10a.eu
domains2:minus-10b.eu
domains3:minus-10c.eu
domains4:minus-10d.eu
domains5:minus-10e.eu
period:2
owner-contact-email:hans@nose.net
owner-contact-individual:Y
owner-contact-lname:nose
owner-contact-fname:hans
owner-contact-address-1:horsefair mews
owner-contact-city:romsey
owner-contact-postal-code:4711
owner-contact-country:DE
owner-contact-phone:44 13383794 504040
admin-contact-handle:same-as-owner-contact
tech-contact-handle:same-as-admin-contact
billing-contact-handle:same-as-tech-contact
ns1-domain-name:nsxx1.gonzo.net
ns1-ip-address:194.201.101.1
ns2-domain-name:nsxx1.gonzo.net
ns2-ip-address:194.201.101.2

Last update: 2015-07-29 12:02

Modify a domain

Introduction
 
 
 
 
modify <tld>-domain
 


Valid values for <tld>:

 

 

 
With this request you can modify existing domains. You have to provide the following information within the request:

The system will ignore not specified handles, so you have to provide only the handles, you would like to change.

 


Changes within the owner-contact

In case of changing the owner-contact-handle, the system checks, if lname and/or fname and/or organization differ from the original owner-contact-handle. If there are differences these changes will be ignored.

 


Request fields

 

mailsubject: modify <tld>-domain [your reference id]

 

Definition of this request

 

request-field valid values required
tld com|net|org|info|mobi|name|us|de biz|eu yes
sld [a-z0-9-]{1,63} [a-z0-9][a-z0-9-]{1,61}[a-z0-9] yes
owner-contact-handle
Please, refer to the table below for the valid values.

no
admin-contact-handle no
tech-contact-handle no
billing-contact-handle no
ns1-handle @ns no
ns2-handle no
ns3-handle no
ns4-handle no
ns5-handle no
ns6-handle no

 

 

tld contact handle
com @comcont
net @netcont
org @orgcont
info @infocont
biz @bizcont
mobi @mobicont
name @namecont
us @uscont
de @decont
cn @cncont
eu @eucont

 

 

Example 1: modify com-domain

subject: modify domain [your reference id]

sld:gonzo
tld:com
admin-contact-handle:gonzo@nose.com#0
tech-contact-handle:hans@nose.com
ns1-handle:ns1.gonzo.net
ns2-handle:ns2.gonzo.net

 

Example 2: modify net-domain

subject: modify net-domain [your reference id]

sld:gonzo
tld:net
admin-contact-handle:CNET-1234
tech-contact-handle:CNET-1234
ns1-handle:ns1.gonzo.net
ns2-handle:ns2.gonzo.net

 

Example 3: modify org-domain

subject: modify net-domain [your reference id]

sld:gonzo
tld:org
admin-contact-handle:CORG-1234
tech-contact-handle:CORG-1234
ns1-handle:ns1.gonzo.net
ns2-handle:ns2.gonzo.net

 

Example 4: modify info-domain

subject: modify info-domain [your reference id]

sld:gonzo
tld:info
admin-contact-handle:C112234-LRMS
tech-contact-handle:C112244-LRMS
ns1-handle:ns1.gonzo.net
ns2-handle:ns2.gonzo.net

OR 

modify info-domain (new naming convention for info-handles) 

subject: modify info-domain [your reference id]

sld:gonzo
tld:info
admin-contact-handle:C112244-LRMS
tech-contact-handle:CAFI-007
ns1-handle:ns1.gonzo.net
ns2-handle:ns2.gonzo.net

 

Example 5: modify biz-domain

subject: modify biz-domain [your reference id]

sld:gonzo
tld:biz
admin-contact-handle:CNEU-11224
tech-contact-handle:CNEU-112244
ns1-handle:ns1.gonzo.net
ns2-handle:ns2.gonzo.net

 

Example 6: modify mobi-domain

subject: modify mobi-domain [your reference id]

sld:gonzo
tld:mobi
admin-contact-handle:COMO-1234
tech-contact-handle:COMO-1234
ns1-handle:ns1.gonzo.net
ns2-handle:ns2.gonzo.net

 

Example 7: modify name-domain

subject: modify name-domain [your reference id]

sld:gonzo
tld:name
admin-contact-handle:CNAM-1234
tech-contact-handle:CNAM-1234
ns1-handle:ns1.gonzo.net
ns2-handle:ns2.gonzo.net

 

Example 8: modify us-domain

subject: modify us-domain [your reference id]

sld:gonzo
tld:us
admin-contact-handle:COUS-1234
tech-contact-handle:COUS-1234
ns1-handle:ns1.gonzo.net
ns2-handle:ns2.gonzo.net

 

Example 9: modify de-domain

subject: modify de-domain [your reference id]

sld:gonzo
tld:de
admin-contact-handle:CODE-1234
tech-contact-handle:CODE-1234
ns1-handle:ns1.gonzo.net
ns2-handle:ns2.gonzo.net

Example 10: modify cn-contact

subject: modify cn-contact [your reference id]

handle:COCN-1235
address-1:horsefair mews
postal-code:4711
city:romsey
country:DE
phone:44 13383794 504040

Example 11: modify eu-domain

subject: modify eu-domain [your reference id]

sld:gonzo
tld:eu
admin-contact-handle:C112244
tech-contact-handle:C112244
ns1-handle:ns1.gonzo.net
ns2-handle:ns2.gonzo.net

 

Last update: 2015-07-29 12:02

Renew a domain

Introduction

renew <tld>-domain
Valid values for <tld>:
With this request you can renew up to 500 domains at Joker.com.

You have to provide the following information within the request:

You can renew up to 500 domains with one request.


Due to the fact, that you can renew more than 1 domain with one request, the format is a little bit different from the other requests. Please check the given examples on how to specify the renewal period.

If the sum of the expire time and the renewal time is more then 10 years, we will reject your request.

This request is not working for domains, which are located on the old system. For these domains you have to check the documentation of the old system.

If you provide the expire year, this request will rejected, if the current expire year is greater than the desired. This feature prevents an error in case 1 renew-request is sent twice by mistake.


Request fields

mailsubject: renew <tld>-domain [your reference id]

Definition of this request

You have to provide the domain name and the renewal period or the desired expire year using the format "YYYY" on one line. You have to seperate each field with a ":" (ASCII 058). The maximum for the renewal period is 9 years.

request-field valid values required
domains[0..500] [a-z0-9-]{1,63}\.<tld>:([1-9]|\d{4}) yes

 

.COM renewal

Example 1: renew 1 domain for 1 year using the field period

subject: renew com-domain [your reference id]

domains0:minus-109.com:1


Example 2: renew 5 domains for 4 years using the field period

subject: renew com-domain [your reference id]

domains0:minus-109.com:4
domains1:minus-119.com:4
domains2:minus-129.com:4
domains3:minus-139.com:4
domains4:minus-149.com:4


Example 3: renew 5 domains for different years using the field period

subject: renew com-domain [your reference id]

domains0:minus-109.com:1
domains1:minus-119.com:2
domains2:minus-129.com:3
domains3:minus-139.com:4
domains4:minus-149.com:5


Example 4: renew 1 domain using the field expirationyear

subject: renew com-domain [your reference id]

domains0:minus-109.com:2005

 

.NET Renewal

 

Example 1: renew 1 domain for 1 year using the field period

subject: renew net-domain [your reference id]

domains0:minus-109.net:1


Example 2: renew 5 domains for 4 years using the field period

subject: renew net-domain [your reference id]

domains0:minus-109.net:4
domains1:minus-119.net:4
domains2:minus-129.net:4
domains3:minus-139.net:4
domains4:minus-149.net:4


Example 3: renew 5 domains for different years using the field period

subject: renew net-domain [your reference id]

domains0:minus-109.net:1
domains1:minus-119.net:2
domains2:minus-129.net:3
domains3:minus-139.net:4
domains4:minus-149.net:5


Example 4: renew 1 domain using the field expirationyear

subject: renew net-domain [your reference id]

domains0:minus-109.net:2005
 

.ORG Renewal

Example 1: renew 1 domain for 1 year using the field period

subject: renew org-domain [your reference id]

domains0:minus-109.org:1


Example 2: renew 5 domains for 4 years using the field period

subject: renew org-domain [your reference id]

domains0:minus-109.org:4
domains1:minus-119.org:4
domains2:minus-129.org:4
domains3:minus-139.org:4
domains4:minus-149.org:4


Example 3: renew 5 domains for different years using the field period

subject: renew org-domain [your reference id]

domains0:minus-109.org:1
domains1:minus-119.org:2
domains2:minus-129.org:3
domains3:minus-139.org:4
domains4:minus-149.org:5


Example 4: renew 1 domain using the field expirationyear

subject: renew org-domain [your reference id]

domains0:minus-109.org:2005

 

.INFO Renewal

Example 1: renew 1 domain for 1 year using the field period

subject: renew info-domain [your reference id]

domains0:minus-109.info:1


Example 2: renew 5 domains for 4 years using the field period

subject: renew info-domain [your reference id]

domains0:minus-109.info:4
domains1:minus-119.info:4
domains2:minus-129.info:4
domains3:minus-139.info:4
domains4:minus-149.info:4


Example 3: renew 5 domains for different years using the field period

subject: renew info-domain [your reference id]

domains0:minus-109.info:1
domains1:minus-119.info:2
domains2:minus-129.info:3
domains3:minus-139.info:4
domains4:minus-149.info:5


Example 4: renew 1 domain using the field expirationyear

subject: renew info-domain [your reference id]

domains0:minus-109.info:2005


.BIZ Renewal

Example 1: renew 1 domain for 1 year using the field period

subject: renew biz-domain [your reference id]

domains0:minus-109.biz:1


Example 2: renew 5 domains for 4 years using the field period

subject: renew biz-domain [your reference id]

domains0:minus-109.biz:4
domains1:minus-119.biz:4
domains2:minus-129.biz:4
domains3:minus-139.biz:4
domains4:minus-149.biz:4


Example 3: renew 5 domains for different years using the field period

subject: renew biz-domain [your reference id]

domains0:minus-109.biz:1
domains1:minus-119.biz:2
domains2:minus-129.biz:3
domains3:minus-139.biz:4
domains4:minus-149.biz:5


Example 4: renew 1 domain using the field expirationyear

subject: renew biz-domain [your reference id]

domains0:minus-109.biz:2005

.NAME Renewal

Example 1: renew 1 domain for 1 year using the field period

subject: renew name-domain [your reference id]

domains0:minus-109.name:1


Example 2: renew 5 domains for 4 years using the field period

subject: renew name-domain [your reference id]

domains0:minus-109.name:4
domains1:minus-119.name:4
domains2:minus-129.name:4
domains3:minus-139.name:4
domains4:minus-149.name:4


Example 3: renew 5 domains for different years using the field period

subject: renew name-domain [your reference id]

domains0:minus-109.name:1
domains1:minus-119.name:2
domains2:minus-129.name:3
domains3:minus-139.name:4
domains4:minus-149.name:5


Example 4: renew 1 domain using the field expirationyear

subject: renew name-domain [your reference id]

domains0:minus-109.name:2005

 

.US Renewal

Example 1: renew 1 domain for 1 year using the field period

subject: renew us-domain [your reference id]

domains0:minus-109.us:1


Example 2: renew 5 domains for 4 years using the field period

subject: renew us-domain [your reference id]

domains0:minus-109.us:4
domains1:minus-119.us:4
domains2:minus-129.us:4
domains3:minus-139.us:4
domains4:minus-149.us:4


Example 3: renew 5 domains for different years using the field period

subject: renew us-domain [your reference id]

domains0:minus-109.us:1
domains1:minus-119.us:2
domains2:minus-129.us:3
domains3:minus-139.us:4
domains4:minus-149.us:5


Example 4: renew 1 domain using the field expire year

subject: renew us-domain [your reference id]

domains0:minus-109.net:2005

 

.DE Renewal


Example 1: renew 1 domain for 1 year using the field period

subject: renew de-domain [your reference id]

domains0:minus-109.de:1


Example 2: renew 5 domains for 4 years using the field period

subject: renew de-domain [your reference id]

domains0:minus-109.de:4
domains1:minus-119.de:4
domains2:minus-129.de:4
domains3:minus-139.de:4
domains4:minus-149.de:4


Example 3: renew 5 domains for different years using the field period

subject: renew de-domain [your reference id]

domains0:minus-109.de:1
domains1:minus-119.de:2
domains2:minus-129.de:3
domains3:minus-139.de:4
domains4:minus-149.de:5


Example 4: renew 1 domain using the field expirationyear

subject: renew de-domain [your reference id]

domains0:minus-109.de:2005

 

.CN Renewal

Example 1: renew 1 domain for 1 year using the field period

subject: renew cn-domain [your reference id]

domains0:minus-109.cn:1


Example 2: renew 5 domains for 4 years using the field period

subject: renew cn-domain [your reference id]

domains0:minus-109.cn:4
domains1:minus-119.cn:4
domains2:minus-129.cn:4
domains3:minus-139.cn:4
domains4:minus-149.cn:4


Example 3: renew 5 domains for different years using the field period

subject: renew cn-domain [your reference id]

domains0:minus-109.cn:1
domains1:minus-119.cn:2
domains2:minus-129.cn:3
domains3:minus-139.cn:4
domains4:minus-149.cn:5


Example 4: renew 1 domain using the field expire year

subject: renew cn-domain [your reference id]

domains0:minus-109.cn:2005

 

Last update: 2011-08-11 14:18

Transfer a domain

Introduction

transfer <tld>-domain

Valid values for <tld>:

 

With this request you can transfer a domain from 1 registrar to Joker.com.

You have to provide the following information within the request:


You can transfer 1 com domain with one request.

If you transfer a domain to Joker.com the domain will be renewed for one year.

As you can see, we dont need information about the owner-contact. We will detect this information from the whois of the current registrar and we will create the contact-handle for the owner-contact automatically.
You need to provide us with a so called auth-id. You have to ask the current registrar for this auth-id. If you provide an invalid auth-id, the transfer will be declined by the current registrar.

As you can see, we need the billing-contact-handle. We recommend using a billing-handle with the email-address of your "robot-email". If you use a contact-handle with a different e-mail than your robot e-mail, you can't administer the transfered domain using the webinterface and the person with access to the email, which is shown in the provided billing-handle will have access using the web-interface.

If you don't have a com-contact-handle with your "robot-email", you have to create a com-handle using the "create com-contact" request.

We do not need information about the nameservers. This information will be detected from the whois of the current registrar and we will create the nameservers if necessary.


This procedure implies, that an owner change or change of nameservers during the transfer-process is not possible.

Request fields

mailsubject: transfer <tld>-domain [your reference id]

ATTENTION:

You can transfer 1 domain with one request.

Definition of this request


request-field valid values required
domains0 [a-z0-9-]{1,63}\.<tld> yes
auth-id .*
yes
billing-contact-handle Please, refer to the table below.
yes

 

tld billing-contact-handle
com @comcont
net @netcont
org @orgcont
info @infocont
biz @bizcont
mobi @mobicont
name @namecont
us @uscont
de @decont
cn @cncont
eu @eucont


TRANSFER COM DOMAIN

Example 1: transfer com-domain

subject: transfer com-domain [your reference id]
domains0:minus-109.com
auth-id:0293XaAdA
billing-contact-handle:CCOM-1234

TRANSFER NET DOMAIN

Example 1: transfer net-domain

subject: transfer net-domain [your reference id]

domains0:minus-109.net
auth-id:0293XaAdA
billing-contact-handle:CNET-1234

TRANSFER ORG DOMAIN

Example 1: transfer org-domain

subject: transfer org-domain [your reference id]

domains0:minus-109.org
auth-id:0293XaAdA
billing-contact-handle:CORG-1234

TRANSFER INFO DOMAIN

Example 1: transfer info-domain

subject: transfer info-domain [your reference id]

domains0:minus-109.info
auth-id:0293XaAdA
billing-contact-handle:C176269-LRMS


TRANSFER BIZ DOMAIN

Example 1: transfer biz-domain

subject: transfer biz-domain [your reference id]

domains0:minus-109.biz
auth-id:0293XaAdA
billing-contact-handle:CNEU-123

TRANSFER NAME DOMAIN

Example 1: transfer name-domain

subject: transfer name-domain [your reference id]

domains0:minus-109.name
auth-id:0293XaAdA
billing-contact-handle:CNAM-1234

TRANSFER US DOMAIN

Example 1: transfer us-domain

subject: transfer us-domain [your reference id]

domains0:minus-109.us
auth-id:0293XaAdA
billing-contact-handle:COUS-1234

TRANSFER DE DOMAIN

Example 1: transfer de-domain

subject: transfer de-domain [your reference id]

domains0:minus-109.de
auth-id:0293XaAdA
billing-contact-handle:CODE-1234

TRANSFER CN DOMAIN

Example 1: transfer cn-domain

subject: transfer cn-domain [your reference id]

domains0:minus-109.cn
auth-id:0293XaAdA
billing-contact-handle:COCN-1234

Last update: 2011-08-11 14:14

Delete a domain

Introduction


With this request you can delete a domain at Joker.com.

You have to provide the following information within the request:


ATTENTION:

If you delete a domain within the first 72 hours after the registration, the registration-fee will be refunded to your account.

If Joker.com receives the delete-request more than 72 hours after the registration, you have to provide the flag "force:1", in order to accept that the registration-fee will not be refunded to your account. If you do not send the "force:1" in such a case, the request will be rejected.
Request fields

mailsubject: delete domain [your reference id]

Definition of this request

Please, do not forget to provide the domain name and the force-flag set to 1 if the domain is older 72h.
request-field valid values required
tld (com|net|org|info|biz|mobi|name|de|cn|eu|us) yes
sld [a-z0-9-]{1,63} yes
force 1|0 no

 

DELETE COM DOMAIN

Example 1: delete a domain during the first 72 hours after registration
subject: delete domain [your reference id]

tld:com
sld:frezel


Example 2: delete a domain after the first 72 hours after registration
subject: delete domain [your reference id]

tld:com
sld:frezel
force:1


Example 3: delete a domain only for the case that a refund is possible!
subject: delete domain [your reference id]

tld:com
sld:frezel
force:0

Last update: 2011-08-11 15:45

List domains

Introduction

list domains


With this request you can get a list (lexicographically sorted) of all the domains, you have currently registered at joker.com.

You have to provide the target-registry within the request:

cno = .com/.net
com = .net
net = .net
org = .org
info = .info
biz = .biz
mobi = .mobi
name = .mobi
de = .de
cn = .cn
eu = .eu
us = .us


LIMITATIONS:

Request fields

mailsubject: list domains [your reference id]

Definition of this request:

request-field valid values required
target com|net|org|info|mobi|name|biz|de|cn|eu|us yes

 

LIST DOMAINS


Example 1: list domains for .com-domains

subject: list domains [your reference id]

target:com


Example 2: list domains for .net-domains

subject: list domains [your reference id]

target:net


Example 3: list domains for .org-domains

subject: list domains [your reference id]

target:org


Example 4: list domains for .info-domains

subject: list domains [your reference id]

target:info


Example 5: list domains for .biz-domains

subject: list domains [your reference id]

target:biz


Example 6: list domains for .de-domains

subject: list domains [your reference id]

target:de


Example 7: list domains for .cn-domains

subject: list domains [your reference id]

target:cn
 

Last update: 2011-08-11 15:44

Lock a domain

Introduction

lock domain

With this request you can lock a domain in order to prevent fraudulent transfer attempts. If a domain is locked, each transfer-request from a foreign registrar will be declined.

You have to provide the following information within the request:

You can lock 1 domain with one request.

Request fields

mailsubject: lock domain [your reference id]

Definition of this request

request-field valid values required
fqdn @fqdn yes

 


Example 1: lock a domain

subject: lock domain [your reference id]

fqdn:minus-109.com 

 

Last update: 2011-08-11 15:46

Unlock a domain

Introduction

unlock domain

With this request you can unlock a domain. If you want to transfer a domain to a foreign registrar, the domain has to be unlocked.

You have to provide the following informations within the request:

You can unlock 1 domain with one request.

Request fields

mailsubject: unlock domain [your reference id]

Definitions of this request

request-field valid values required
fqdn @fqdn yes

 

Example 1: unlock a domain

subject: unlock domain [your reference id]

fqdn:minus-109.com

 

Last update: 2011-08-11 15:46

Get Auth-id

Introduction

With this request you can retrieve the auth-id for a particular domain. That request is needed only for the TLD's .org/.info/.biz.

You have to provide the following information within the request:

You can retrieve the auth-id for 1 domain with one request.

Request fields

mailsubject: get auth-id [your reference id]

Definition of this request

request-field valid values required
fqdn @orgdom @infodom @bizdom @cndom @eudom @usdom yes

 

Example 1: retrieve the auth-id for a .org-domain

subject: get auth-id [your reference id]

fqdn:minus-109.org


Example 2: retrieve the auth-id for a .biz-domain

subject: get auth-id [your reference id]

fqdn:minus-109.biz


Example 3: retrieve the auth-id for a .eu-domain

subject: get auth-id [your reference id]

fqdn:minus-109.eu
 

Last update: 2011-08-11 15:46

Grant Roles/Domain Permissions, Internal Transfer

Introduction

With this request you can assign 'Roles' (permissions) of domains to other Joker.com users. The special role "creator" is an equivalent to an internal transfer of that domain to another Joker.com user.In this case, the domain is assigned to the receiving account, including all rights and permissions on this domain.

There are two variants to use this functionality: If the user id (Joker.com user account id) is given, and the account id matches the associated email address, the role is applied immediately - there will be no request for confirmation on the receiver's side. In case the user id is not given, but only the email address, the transaction has to be acknowledged by the receiver. For this, he will get an email, containing a link and a key. Either the link has to be clicked, or the key has to be applied using Joker.com (=> Transfer). This can also be used for users which do not yet have a Joker.com account.

You have to provide the following parameters:

The following parameters are optional:

Request fields

mailsubject: joker-internal-transfer [your reference id]

Definition of this request

Valid values for <tld>: all Joker.com tlds

request-field valid values required
fqdn [a-z0-9-]{1,63}\.<tld>  yes

destination-client-email

 @email

 yes

destination-client-id

 [0-9]+

 no

desired-role

 admin|tech|billing|creator (if omitted, default is 'creator')

 no

 

Example 1: assign 'billing'-role to user 123456 (direct)

 

subject: joker-internal-transfer [your reference id]

body:
fqdn:exampledomain.com
destination-client-email:example-user@gmail.com
destination-client-id:123456
desired-role:billing

Example 2: assign 'creator'-role to user 'example-user@gmail.com' (internal transfer with invitation)

subject: joker-internal-transfer [your reference id]

body:

fqdn:exampledomain.com
destination-client-email:example-user@gmail.com
desired-role:creator


Last update: 2011-08-17 09:35

2. Reseller Docs >> 2.3 Email Gateway >> Requests >> Contacts

Create a contact

Introduction

 

create <tld>-order

Valid values for <tld>:


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:

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

Last update: 2011-08-11 15:38

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.


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
 

Last update: 2011-08-11 15:39

Change an address

Introduction

change <tld>-address

Valid values for <tld>:


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:


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

Last update: 2011-08-11 15:39

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

Last update: 2016-11-21 15:06

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

Last update: 2011-08-11 15:41

2. Reseller Docs >> 2.3 Email Gateway >> Requests >> Nameservers

Create a nameserver

Introduction

create <tld>-ns

Valid values for <tld>:

 

With this request you can create an entry for a nameserver in the Joker.com database. If a nameserver is created, you can reference this nameserver using the hostname during a "create order"-request.

ATTENTION:

Only nameservers, which Joker.com is respondsible for, will be shown with the ip-address in the whois-output.

If you submit a "create-ns"-request for a nameserver under a domain, which is not registered with Joker.com or for a nameserver under a country-code-domain, the values for the ip-addresses are ignored.

 

 

Request fields

mailsubject: create <tld>-ns [your reference id]

request-field valid values required
ns-domain-name ([a-z0-9-]{1,63}\.)+(@country|com|net|org|int|edu|mil|biz|info|mobi|name) yes
ns-ip-address @ip yes

 

CREATE COM NAMESERVER

Example 1: create com-ns

subject: create com-ns [your reference id]

ns-domain-name:ns1.dummy.com
ns-ip-address:194.111.43.1

CREATE NET NAMESERVER

Example 1: create net-ns

subject: create net-ns [your reference id]

ns-domain-name:ns1.dummy.net
ns-ip-address:194.111.43.1

CREATE ORG NAMESERVER

Example 1: create org-ns

subject: create org-ns [your reference id]

ns-domain-name:ns1.dummy.org

ns-ip-address:194.111.43.1

CREATE INFO NAMESERVER

Example 1: create info-ns

subject: create info-ns [your reference id]

ns-domain-name:ns1.dummy.info
ns-ip-address:194.111.43.1

 

CREATE BIZ NAMESERVER

Example 1: create biz-ns

subject: create biz-ns [your reference id]

ns-domain-name:ns1.dummy.biz

ns-ip-address:194.111.43.1

CREATE NAME NAMESERVER

Example 1: create name-ns

subject: create name-ns [your reference id]

ns-domain-name:ns1.dummy.name
ns-ip-address:194.111.43.1

CREATE US NAMESERVER

Example 1: create us-ns

subject: create us-ns [your reference id]

ns-domain-name:ns1.dummy.us
ns-ip-address:194.111.43.1

CREATE DE NAMESERVER

Example 1: create de-ns

subject: create de-ns [your reference id]

ns-domain-name:ns1.dummy.de
ns-ip-address:194.111.43.1

CREATE CN NAMESERVER

Example 1: create cn-ns

subject: create cn-ns [your reference id]

ns-domain-name:ns1.dummy.cn
ns-ip-address:194.111.43.1

CREATE EU NAMESERVER

Example 1: create eu-ns

subject: create eu-ns [your reference id]

ns-domain-name:ns1.dummy.net
ns-ip-address:194.111.43.1

Last update: 2011-08-11 15:42

Modify a nameserver

Introduction

modify <tld>-ns

Valid values for <tld>:



With this request you can change the ip-address of a nameserver in the Joker.com database.

ATTENTION:

Only nameservers, which Joker.comis respondsible for, will be shown with the ip-address in the whois-output, so only these nameservers could be changed.

If you submit a "modify-ns"-request for a nameserver under a domain, which is not registered with Joker.com or for a nameserver under a country-code-domain, this request will be ignored.

Request fields

mailsubject: modify <tld>-ns [your reference id]

Definition of this request

request-field valid values required
ns-handle ([a-z0-9-]{1,63}\.)+(@country|com|net|org|int|edu|mil|biz|info|mobi|name) yes
ns-ip-address @ip yes

 

MODIFY COM NAMESERVER

Example 1: modify com-ns

subject: modify com-ns [your reference id]

ns-handle:ns1.dummy.com
ns-ip-address:194.111.43.1

 

MODIFY NET NAMESERVER

Example 1: modify net-ns

subject: modify com-ns [your reference id]

ns-handle:ns1.dummy.com
ns-ip-address:194.111.43.1

 

MODIFY ORG NAMESERVER

Example 1: modify org-ns

subject: modify org-ns [your reference id]

ns-handle:ns1.dummy.org
ns-ip-address:194.111.43.1


MODIFY INFO NAMESERVER

Example 1: modify info-ns

subject: modify info-ns [your reference id]

ns-handle:ns1.dummy.info
ns-ip-address:194.111.43.1

 

MODIFY BIZ NAMESERVER

Example 1: modify biz-ns

subject: modify biz-ns [your reference id]

ns-handle:ns1.dummy.biz ns-ip-address:194.111.43.1


MODIFY NAME NAMESERVER

Example 1: modify name-ns

subject: modify name-ns [your reference id]

ns-handle:ns1.dummy.name
ns-ip-address:194.111.43.1

 

MODIFY US NAMESERVER

Example 1: modify us-ns

subject: modify us-ns [your reference id]

ns-handle:ns1.dummy.us
ns-ip-address:194.111.43.1

 

MODIFY DE NAMESERVER

Example 1: modify de-ns

subject: modify de-ns [your reference id]

ns-handle:ns1.dummy.de
ns-ip-address:194.111.43.1


MODIFY CN NAMESERVER

Example 1: modify cn-ns

subject: modify cn-ns [your reference id]

ns-handle:ns1.dummy.cn
ns-ip-address:194.111.43.1

 

MODIFY EU NAMESERVER

Example 1: modify eu-ns

subject: modify eu-ns [your reference id]

ns-handle:ns1.dummy.com
ns-ip-address:194.111.43.1

 

Last update: 2011-08-11 15:42

2. Reseller Docs >> 2.3 Email Gateway >> Requests >> Other

Support

Introduction

 
With this request you can send a question to the support team at Joker.com. Only questions, which are sent to the e-mail gateway are accepted.


ATTENTION:

Please, make sure that you sign your message with the keyset sent by you to Joker.com during your reseller registration. Please, also make sure not to include any characters that are not part of the 7-bit ASCII standard and do not use trailing blanks (i.e. every non blank line has to end with a non-whitespace character).
 
Request fields
 
mailsubject: support [your reference id]
 
Example 1

subject: support [your reference id]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Enter your question here.
Dont forget the fqdn in question

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.0.2 (GNU/Linux)
Comment: For info see http://www.gnupg.org

iD7DBQE6ZtMfzWqd+drNYRURAuW4AJ4nRewOrNc+yLMmmCouVcMP3v5nWQCdHUlf
tJk/gOuFmDnIs3JS+7eRjnA=
=Fwmc
-----END PGP SIGNATURE-----

Last update: 2011-08-11 15:43