# domainCHECK Request

Function

This request is used to find out about the status of a domain.

Requirements

None.

Request Parameters

Contact CHECK request comprises the parameters described below:

K/V Keyword | XML Namespace and Element | Occurrence min - max | Type / Length | Value Range | Description
--- | --- | --- | --- | --- | ---
Action | domain:check | 1 | enumeration | check-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.
Domain | domain:handle | 1 | token 4 - 66 | domain-rule | This is the domain name.
Domain-Ace | domain:ace | 0 - 1 | token 4 - 66 | domainace-rule | This is the ACE form (ASCII Compatible Encoding) of the domain name.

## Examples

- xml
- k/v

Copy

format: xml
request: domainCHECK

    1
    2
    3
    4
    5
    6
    7
    <?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">
      <domain:check>
        <domain:handle>de-example.de</domain:handle>
      </domain:check>
    </registry-request>

Copy

format: xml
response: domainCHECK

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    <?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>9e986503-9a2c-11df-a9e2-9519b5688882</tr:stid>
        <tr:result>success</tr:result>
        <tr:data>
          <domain:checkData xmlns:domain="http://registry.denic.de/domain/5.0">
            <domain:handle>test.de</domain:handle>
            <domain:status>connect</domain:status>
          </domain:checkData>
        </tr:data>
      </tr:transaction>
    </registry-response>

Copy

format: xml
response: domainCHECK
status: pendigCreate

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    <registry-response xmlns="http://registry.denic.de/global/5.0" xmlns:tr="http://registry.denic.de/transaction/5.0">
      <tr:transaction>
        <tr:stid>0a38e709-33e3-d5cf-cccf-622f9a16f225</tr:stid>
        <tr:result>success</tr:result>
        <tr:data>
          <domain:checkData xmlns:domain="http://registry.denic.de/domain/5.0">
            <domain:handle>de-example.de</domain:handle>
            <domain:ace>de-example.de</domain:ace>
            <domain:status>pendingCreate</domain:status>
          </domain:checkData>
        </tr:data>
      </tr:transaction>
    </registry-response>

Copy

format: xml
response: domainCHECK
status: serverHold

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    <registry-response xmlns="http://registry.denic.de/global/5.0" xmlns:tr="http://registry.denic.de/transaction/5.0">
      <tr:transaction>
        <tr:stid>0a38e709-33e3-d5cf-cccf-622f9a16f225</tr:stid>
        <tr:result>success</tr:result>
        <tr:data>
          <domain:checkData xmlns:domain="http://registry.denic.de/domain/5.0">
            <domain:handle>denic-server-hold.de</domain:handle>
            <domain:ace>denic-server-hold.de</domain:ace>
            <domain:status>serverHold</domain:status>
          </domain:checkData>
        </tr:data>
      </tr:transaction>
    </registry-response>

Copy

format: k/v
request: domainCHECK

    1
    2
    3
    Version: 5.0
    Action: check
    Domain: de-example.de

Copy

format: k/v
response: domainCHECK

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

    Domain: de-example.de
    Status: exist

Copy

format: k/v
response: domainCHECK
status: pendigCreate

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

    Domain: de-example.de
    Domain-Ace: de-example.de
    Status: pendigCreate

Copy

format: k/v
response: domainCHECK
status: serverHold

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

    Domain: de-example.de
    Domain-Ace: de-example.de
    Status: serverHold