# Domains ## Create an order **Introduction** create <tld>-order Valid values for <tld>: - com - net - org - info - biz - mobi - name - us - de - cn - eu - xxx - asia - me With this request you can register one or more domains. You have to provide the following information within the request: - domain name(s), - owner-contact-handle, - admin-contact-handle, - tech-contact-handle, - billing-contact-handle, - nameserver information, - additional services, if required. 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: - name - address-3 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>
meCOME-<number>
asiaCOAS-<number>
xxxCONX-<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 yesyesno (IDN domains only)
tld owner-contact-handle admin-contact-handle tech-contact-handlebilling-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 ## Modify a domain
**Introduction**
renew <tld>-domain
Valid values for <tld>:
- com - net - org - info - biz - mobi - name - us - de - cn
With this request you can renew up to 500 domains at Joker.com.
You have to provide the following information within the request:
- the domainname(s), - the renewalperiod or the desired expirationyear
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-fieldvalid valuesrequired
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 ## Renew a domain
**Introduction**
renew <tld>-domain
Valid values for <tld>:
- com - net - org - info - biz - mobi - name - us - de - cn
With this request you can renew up to 500 domains at Joker.com.
You have to provide the following information within the request:
- the domainname(s), - the renewalperiod or the desired expirationyear
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-fieldvalid valuesrequired
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 ## Transfer a domain **Introduction** transfer <tld>-domain
Valid values for <tld>:
- com - net - org - info - biz - mobi - name - us - de - cn
With this request you can transfer a domain from 1 registrar to Joker.com. You have to provide the following information within the request: - the domain name, - the auth-id, - the billing-contact-handle, 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-fieldvalid valuesrequired
domains0\[a-z0-9-\]{1,63}\\.<tld>yes
auth-id.\* yes
billing-contact-handlePlease, 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 ## 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: - domain name(s), - the special flag force 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-fieldvalid valuesrequired
tld(com|net|org|info|biz|mobi|name|de|cn|eu|us)yes
sld\[a-z0-9-\]{1,63} yes
force1|0no
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
## 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: - Only 20.000 domains are listed. If you have more than 20.000 domains under 1 registry at joker.com, you have to track the domain names yourself. - In case you have more than 20.000 domains at joker.com under 1 registry, this request will not work for you. The listing would be incomplete and it will be missing random domains. - This request works only with the new joker.com system. **Request fields** mailsubject: list domains \[your reference id\] Definition of this request:
request-fieldvalid valuesrequired
targetcom|net|org|info|mobi|name|biz|de|cn|eu|usyes
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 ## 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: - domain name You can lock 1 domain with one request. **Request fields** mailsubject: lock domain \[your reference id\] Definition of this request
request-fieldvalid valuesrequired
fqdn@fqdnyes
**Example 1:** lock a domain subject: lock domain \[your reference id\] fqdn:minus-109.com
## 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: - domain name You can unlock 1 domain with one request. **Request fields** mailsubject: unlock domain \[your reference id\] Definitions of this request
request-fieldvalid valuesrequired
fqdn@fqdnyes
**Example 1:** unlock a domain subject: unlock domain \[your reference id\] fqdn:minus-109.com ## 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: - domain name 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[ ](https://joker.com/faq/content/45/183/en/valid-domain-names.html) 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 ## 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: - domain name (the domain you want to grant somebody else permissions on) - destination client email (the email address of the user you want to receive permissions) The following parameters are optional: - destination client id (ID of Joker.com account - always shown in the upper right on Joker.com, also conforms to "reseller id" - must match the 'destination client email') - desired role (type of permission you want to assign to "client email" resp. "client id" - one of "admin|tech|billing|creator"; "creator" means "all permissions" and is equivalent to an **internal transfer** or 'assignment' - also see 'roles ') **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 ```