---
title: "Domain premium group list"
url: "https://help.internetx.com/en/api/core-domain-premium-group-list/"
lang: "en"
section: "API reference — API reference (XML/JSON)"
breadcrumb: "API documentation (JSON/XML) > Tasks > Domain premium tasks"
updated: "2023-09-18"
---

# Domain premium group list

## Function

The _DomainPremiumGroupList_ task creates a list with specific details of the available premium domains. The order type is currently supported only by XML.  

You can find more information about list queries [here](/en/api/core-list-inquire/).  

## Description

-   [**XML**](#87031 "XML")

Task code: 01605  
Uses [Domain Premium](/en/api/core-domain-premium-object/) object  

**Premium domains sorted in ascending order.**

```
<request>
    <auth>
        <user>customer</user>
        <password>password</password>
        <context>4</context>
    </auth>
    <task>
        <code>0165</code>
        <view>
            <offset>0</offset>
            <limit>3</limit>
        </view>
        <order>
            <key>name</key>
            <mode>asc</mode>
        </order>
    </task>
</request> 
```

```
<response>
    <result>
        <data>
            <summary>26571199</summary>
            <domain_premium>
                <name>0.abogado</name>
                <price_class />
                <status>ASSIGNED</status>
                <provider>registry</provider>
                <owner>
                    <user>support</user>
                    <context>1</context>
                </owner>
                <id>107307598</id>
                <created>2017-09-21 16:29:26</created>
                <updated>2017-08-21 16:29:26</updated>
            </domain_premium>
            <domain_premium>
                <name>0.academy</name>
                <price_class>DONUTS-A</price_class>
                <status>FREE</status>
                <provider>registry</provider>
                <owner>
                    <user>support</user>
                    <context>1</context>
                </owner>
                <id>4050002</id>
                <created>2015-12-14 11:24:57</created>
                <updated>2016-09-26 13:59:39</updated>
            </domain_premium>
            <domain_premium>
                <name>0.accountant</name>
                <price_class>FFM-TIER8</price_class>
                <status>FREE</status>
                <provider>registry</provider>
                <owner>
                    <user>support</user>
                    <context>1</context>
                </owner>
                <id>1493640</id>
                <created>2015-06-11 11:59:26</created>
                <updated>2018-02-20 13:56:23</updated>
            </domain_premium>
        </data>
        <status>
            <code>S0165</code>
            <text>The premium domains were inquired successfully.</text>
            <type>success</type>
        </status>
    </result>
    <stid>20211022-test-130779</stid>
</response>  
```

**All premium TLDs with .care and .dance; sorted in ascending order.  
**

```
<request>
    <auth>
        <user>customer</user>
        <password>test</password>
        <context>4</context>
    </auth>
    <task>
        <code>0165</code>
        <view>
            <offset>0</offset>
            <limit>3</limit>
        </view>
        <where>
            <and>
                <or>
                    <key>name</key>
                    <operator>like</operator>
                    <value>care</value>
                </or>
                <or>
                    <key>name</key>
                    <operator>eq</operator>
                    <value>dance</value>
                </or>
            </and>
        </where>
        <order>
            <key>name</key>
            <mode>asc</mode>
        </order>
    </task>
</request> 
```

```
<response>
	<result>
		<data>
			<summary>2</summary>
			<tld_premium>
				<name>care</name>
				<count>4610</count>
			</tld_premium>
			<tld_premium>
				<name>dance</name>
				<count>7365</count>
			</tld_premium>
		</data>
		<status>
			<code>S01605</code>
			<text>The premium domains were inquired successfully.</text>
			<type>success</type>
		</status>
	</result>
	<stid>20161123-app1-dev-6511</stid>
</response>
```

**All premium domains with price class DONUTS-A+, sorted in ascending order.  
**

```
<request>
    <auth>
        <user>andre-devlab</user>
        <password>test</password>
        <context>4</context>
    </auth>
    <task>
        <code>0165</code>
        <view>
            <offset>0</offset>
            <limit>3</limit>
        </view>
        <where>
            <key>price_class</key>
            <operator>eq</operator>
            <value>DONUTS-A+</value>
        </where>
        <order>
            <key>name</key>
            <mode>asc</mode>
        </order>
    </task>
</request>  
```

```
<response>
    <result>
        <data>
            <summary>8186</summary>
            <domain_premium>
                <name>0.accountants</name>
                <price_class>DONUTS-A+</price_class>
                <status>FREE</status>
                <provider>registry</provider>
                <owner>
                    <user>support</user>
                    <context>1</context>
                </owner>
                <id>4324801</id>
                <created>2015-12-14 11:50:37</created>
                <updated>2016-09-17 10:36:11</updated>
            </domain_premium>
            <domain_premium>
                <name>0.apartments</name>
                <price_class>DONUTS-A+</price_class>
                <status>FREE</status>
                <provider>registry</provider>
                <owner>
                    <user>support</user>
                    <context>1</context>
                </owner>
                <id>4434913</id>
                <created>2015-12-14 12:00:12</created>
                <updated>2016-09-18 21:51:44</updated>
            </domain_premium>
            <domain_premium>
                <name>0.associates</name>
                <price_class>DONUTS-A+</price_class>
                <status>FREE</status>
                <provider>registry</provider>
                <owner>
                    <user>support</user>
                    <context>1</context>
                </owner>
                <id>4130410</id>
                <created>2015-12-14 11:31:56</created>
                <updated>2016-09-27 19:38:54</updated>
            </domain_premium>
        </data>
        <status>
            <code>S0165</code>
            <text>The premium domains were inquired successfully.</text>
            <type>success</type>
        </status>
    </result>
    <stid>20211022-app3-dev-27055</stid>
</response>      
```