# domainCREATE Request

Function

This request is used to register a domain.

Requirements

- The request can only be processed if the domain has not already been registered.

- Before registering the domain you must create the Contacts that are referenced in the request.

Verification

- Domains in the “failed” state are initially bound to the 30-day connection period. After the connection, the risk assessment is carried out.

- If a contact handle (type “PERSON” or “ORG”) with verified contact data is used, every domain registered with a domain CREATE request is automatically verified, provided that the verification result of the contact remains unchanged as “success”.

- A domain CREATE request is also executed if contacts without a phone number or email address are used.

- When the domain is passed to the risk assessment without one of the final statuses “connect” or “serverHold”, the domain status “pendingCreate” is set. An information message is output in the response.

Request Parameters

A Domain CREATE request is composed of the fields of the "Domain" data object and some other parameters, which are described below:

K/V Keyword | XML Namespace and Element | Occurrence min - max | Type / Length | Value Range | Description
--- | --- | --- | --- | --- | ---
Action | domain:create | 1 | enumeration | create-erule | This is the request type.
Version | - | 1 | enumeration | version-erule | This is the version. The keyword is only relevant for requests in the key/value format.
CtId | ctid | 0 - 1 | token 3 - 64 | Any visible Unicode character (according to Unicode version 3.1) | This is the unique transaction ID which is issued by the client.

Common Mistakes

- The requested domain already exists.
- The status of the requested domain is „redemptionPeriod“.
- One of the Contacts stated in the request does not meet the requirements of the role to be assigned to it.
- The Nameserver Predelegation Check failed. You will find descriptions of the checks that are executed in the document "Nameserver Predelegation Check".

## Examples

- xml
- k/v

Copy

format: xml
request: domainCREATE

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <registry-request xmlns="http://registry.denic.de/global/5.0" xmlns:domain="http://registry.denic.de/domain/5.0" xmlns:dnsentry="http://registry.denic.de/dnsentry/5.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
      <domain:create>
        <domain:handle>domain-example-nserver.de</domain:handle>
        <domain:contact role="holder">DENIC-1000022-EXAMPLE-XML-PERSON</domain:contact>
        <domain:contact role="abusecontact">DENIC-1000022-EXAMPLE-XML-GR</domain:contact>
        <domain:contact role="generalrequest">DENIC-1000022-EXAMPLE-XML-ABUSE</domain:contact>
        <dnsentry:dnsentry xsi:type="dnsentry:NS">
          <dnsentry:owner>domain-example-nserver.de</dnsentry:owner>
          <dnsentry:rdata>
            <dnsentry:nameserver>ns1.denic.de</dnsentry:nameserver>
          </dnsentry:rdata>
        </dnsentry:dnsentry>
        <dnsentry:dnsentry xsi:type="dnsentry:NS">
          <dnsentry:owner>domain-example-nserver.de</dnsentry:owner>
          <dnsentry:rdata>
            <dnsentry:nameserver>ns1.domain-example-nserver.de</dnsentry:nameserver>
            <dnsentry:address>81.91.170.12</dnsentry:address>
          </dnsentry:rdata>
        </dnsentry:dnsentry>
      </domain:create>
      <ctid>xml-74ba5155</ctid>
    </registry-request>

Copy

format: xml
response: domainCREATE
status: pendingCreate

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    <?xml version="1.0" encoding="UTF-8"?>

    <registry-response xmlns="http://registry.denic.de/global/5.0" xmlns:tr="http://registry.denic.de/transaction/5.0">
      <tr:transaction>
        <tr:stid>a503e644-635c-4253-b598-84d0c2296a97</tr:stid>
        <tr:ctid>xml-74ba5155</tr:ctid>
        <tr:result>success</tr:result>
        <tr:message level="info" code="53000080014">
          <tr:text>Domain "Status" is "pendingCreate"</tr:text>
        </tr:message>
      </tr:transaction>
    </registry-response>

Copy

format: k/v
request: domainCREATE

    1
    2
    3
    4
    5
    6
    7
    8
    9
    Version: 5.0
    Action: CREATE
    Domain: domain-example-nserver.de
    Holder: DENIC-1000022-EXAMPLE-PERSON
    Generalrequest: DENIC-1000022-EXAMPLE-GR
    Abusecontact: DENIC-1000022-EXAMPLE-ABUSE
    Nserver: ns1.denic.de
    Nserver: ns2.denic.de
    CTID: cba-987654321

Copy

format: k/v
response: domainCREATE
status: pendingCreate

    1
    2
    3
    4
    5
    6
    Result: success
    STID: 74ba5119-74d1-4ba6-935f-4feb07ddd14d

    INFO: 53000080014 Domain "Status" is "pendingCreate"
    STID: 3727d839-497f-4ef9-8aa5-0a1ea16a8c95
    CTID: cba-987654321