Table of Contents

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

Request 
{
    "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
    }
}
Response 
{
    "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 
<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 
<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>