Use the get-domain-list operation to retrieve information about reseller’s domains, subdomains, and domain aliases.

Request Packet Structure

A request XML packet retrieving reseller domains includes the get-domain-list operation node:

<packet>
<reseller>
   <get-domain-list>
   ...
   </get-domain-list>
</reseller>
</packet>

The get-domain-list node has the following graphical representation:

• The filter node is required. It specifies reseller accounts whose domains are to be retrieved. Data type: ResellerSelectionFilter. To view the structure of this node, refer to the Available Filters section.

Response Packet Structure

The get-domain-list node of the response packet is structured as follows:

The result node wraps the response retrieved from the server. Data type: resultFilterType (common.xsd).

• result, required. It wraps the response got from the server. Data type: resultFilterType (common.xsd).
• status, required. It specifies the execution status of the operation. Data type: string. Allowed values: ok | error.
• errcode, optional. It returns the error code when the operation fails. Data type: unsignedInt.
• errtext, optional. It returns the error message if the operation fails. Data type: string.
• filter-id, optional. It returns the parameter by which the reseller account was filtered by in the request packet. Data type: anySimple.
• id, optional. It returns the identifier of the reseller account for which the applications filter was turned on. Data type: id_type (common.xsd).

The information about the domains is held by the domain node, which is presented by complex type domainListOutputType (domain_list.xsd). The node is structured as follows:

• The id node is required. It holds the ID of the domain. Data type: id_type.
• The name node is required. It holds the domain name. Data type: string.
• The ascii-name node is required. It holds the domain name in ASCII characters. Data type: string.
• The type node is required. It holds the domain type (domain, subdomain, alias). Data type: string.
• The main node is required. It indicates whether the domain is the main domain on a subscription. Data type: boolean.
• The guid node is required. It holds the unique identifier of the domain. Data type: string.
• The external-id node is required. It holds the identifier of the domain in an external system. Data type: string.
• The parent-id node is optional. It holds the ID of the parent domain to which the subdomain belongs. Data type: id_type.
• The domain-id node is optional. It holds the ID of the domain to which the domain alias is related. Data type: id_type.

Samples

The following packet retrieves the list of reseller’s domains:

<packet>
<reseller>
     <get-domain-list>
      <filter>
          <id>1</id>
      </filter>
   </get-domain-list>
</reseller>
</packet>

Response:

<packet>
  <reseller>
     <get-domain-list>
      <result>
        <status>ok</status>
        <filter-id>32</filter-id>
        <id>32</id>
        <domains>
          <domain>
            <id>41</id>
            <name>ressub.com</name>
            <ascii-name>ressub.com</ascii-name>
            <type>domain</type>
            <main>true</main>
            <guid>91755d52-849a-45f9-8808-3fc35d913670</guid>
            <external-id/>
          </domain>
          <domain>
            <id>42</id>
            <name>sub1.ressub.com</name>
            <ascii-name>sub1.ressub.com</ascii-name>
            <type>subdomain</type>
            <main>false</main>
            <guid>605aa1d9-cddd-4c90-8d09-769032af5ffa</guid>
            <external-id/>
            <parent-id>41</parent-id>
          </domain>
          <domain>
            <id>7</id>
            <name>subsers.ru</name>
            <ascii-name>subsers.ru</ascii-name>
            <type>alias</type>
            <main>false</main>
            <guid>91755d52-849a-45f9-8808-3fc35d913670</guid>
            <external-id/>
            <domain-id>41</domain-id>
          </domain>
        </domains>
      </result>
    </get-domain-list>
  </reseller>
</packet>