- Home
- API reference
- API documentation (JSON/XML)
- Tasks
- Domain prereg tasks
Domain prereg create plus
Function
The DomainPreregCreatePlus task starts the preregistration for a domain and can create one or more domain contacts. Cf. Domain PreregCreate.
Note that the preregistration phases of each new TLD are limited in time by the regulations of the respective registry.
Description
Route: POST /domainPrereg
{
"name": "example.app",
"tmchMark": {
"reference": "0000061236-1"
},
"status": "OPEN",
"phase": "live",
"nameServers": [
{
"name": "ns1.example.com"
},
{
"name": "ns2.example.com"
}
],
"ownerc": {
"type": "PERSON",
"fname": "John",
"lname": "Doe",
"email": "john.doe@mail.de",
"country": "DE",
"pcode": 23445,
"address": ["examplestreet", "1. flor"],
"city": "examplecity"
},
"techc": {
"id": 23302422
}
}{
"stid": "20210903-app-7619",
"messages": [
{
"text": "Domain contact has been successfully created.",
"objects": [
{
"type": "handle",
"value": "23334071"
}
],
"code": "S0301",
"status": "SUCCESS"
}
],
"status": {
"code": "S0110001",
"text": "The domain has been preregistered successfully.",
"type": "SUCCESS"
},
"object": {
"type": "DomainPrereg",
"value": "example.app",
"data": {
"name": "example.app",
"orderReference": "ed10f0c3-e82f"
}
}
}Task code: 0110001
Uses Domain Prereg object
<request>
<auth>
<user>user</user>
<password>password</password>
<context>4</context>
</auth>
<task>
<code>0110001</code>
<domain_prereg>
<name>example.app</name>
<tmch_mark>
<reference>100115-1</reference>
</tmch_mark>
<phase>live</phase>
<ownerc>
<type>PERSON</type>
<fname>Joseph</fname>
<lname>Doe</lname>
<address>example street</address>
<pcode>23445</pcode>
<city>examplecity</city>
<country>DE</country>
<state></state>
<phone>+49+1-12345-127335</phone>
<fax>+49+1-12345-127335</fax>
<email>Doe@example.com</email>
<protection>A</protection>
<title>Prof.</title>
<organization>example company</organization>
<extension>
<vatnumber>VATNUMBER</vatnumber>
<trademark_number>VATNUMBER</trademark_number>
</extension>
</ownerc>
<adminc>
<type>PERSON</type>
<fname>Sue</fname>
<lname>Doe</lname>
<address>Example Street 123</address>
<pcode>23445</pcode>
<city>Example City</city>
<country>US</country>
<state></state>
<phone>+49-12345-127335</phone>
<fax>+49-12345-127335</fax>
<email>customer@example.com</email>
<protection>A</protection>
<title>Prof.</title>
<organization>Example Company</organization>
<extension>
<vatnumber>VATNUMBER</vatnumber>
<trademark_number>TRADEMARK_NUMBER</trademark_number>
</extension>
</adminc>
<techc>21367745</techc>
<zonec>21367745</zonec>
<nserver>
<name>ns1.example.com</name>
</nserver>
<nserver>
<name>ns2.example.com</name>
</nserver>
</domain_prereg>
<reply_to>user@example.com</reply_to>
<default>
<phase>live</phase>
</default>
</task>
</request><response>
<result>
<data>
<domain_prereg>
<order_reference>28896375-fabf</order_reference>
</domain_prereg>
</data>
<msg>
<text>Domain contact has been successfully created.</text>
<code>S0301</code>
<type>success</type>
<object>
<type>handle</type>
<value>21387944</value>
</object>
</msg>
<msg>
<text>Domain contact has been successfully created.</text>
<code>S0301</code>
<type>success</type>
<msg>
<text>This domain contact already exists and is used. A new contact was not created.</text>
<code>MSG03003</code>
<type>notice</type>
</msg>
<object>
<type>handle</type>
<value>21387945</value>
</object>
</msg>
<status>
<code>S0110001</code>
<text>Domain contact has been successfully created.</text>
<type>success</type>
<object>
<type>domain_prereg</type>
<value>example.app</value>
</object>
</status>
</result>
<stid>20210802-app-3457</stid>
</response>