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

# Domain prereg list

## Function

The DomainPreregList task determines the data of preregistrations.

## Description

Route: POST /domainPrereg/\_search  

**Query parameters**

The data of the following keywords can be queried with the query parameter ?keys\[\]=:

-   tmch\_mark
-   extension
-   nsentry

```
{
    "view": {
        "children": true,
        "offset": 0,
        "limit": 10
    },
    "filters": [
        {
            "key": "tld",
            "operator": "EQUAL",
            "value": "web"
        }
    ]
}
```

```
{
    "stid": "20201226-app-83050",
    "status": {
        "code": "S0110005",
        "text": "Preregistration data were inquired successfully.",
        "type": "SUCCESS"
    },
    "object": {
        "type": "DomainPrereg",
        "summary": 1
    },
    "data": [
        {
            "created": "2013-07-24T17:08:24.000+0200",
            "updated": "2016-07-22T09:44:47.000+0200",
            "owner": {
                "context": 4,
                "user": "customer"
            },
            "ownerc": {
                "id": 199563
            },
            "zonec": {
                "id": 199563
            },
            "adminc": {
                "id": 199563
            },
            "techc": {
                "id": 199563
            },
            "name": "example1.web",
            "nameServers": [
                {
                    "name": "ns1.example.com"
                },
                {
                    "name": "ns2.example.com"
                }
            ],
            "status": "PENDING",
            "phase": "sunrise1",
            "orderReference": "1c3d6112-c4ac",
            "preregConfig": {},
            "recommended": true
        }
    ]
}
```

Task code: 0110005  
Uses [DomainPrereg](/en/api/core-domain-prereg-object/) object

**Keywords**

The following keys can be used for the filters:

-   sld
-   tld
-   subtld
-   id
-   prereg\_config.confirmation\_start
-   prereg\_config.confirmation\_end
-   prereg\_config.period\_start
-   prereg\_config.period\_end

The following keywords are returned by default:

-   adminc
-   recommended
-   confirmed
-   created
-   name
-   nserver
-   order\_reference
-   owner
-   period
-   prereg\_config
-   phase
-   status
-   techc
-   updated
-   updater  
    

The data of the following keywords can be queried with the <key> keyword:

-   tmch\_mark
-   extension
-   nsentry

```
<request>
	<auth>
		<user>customer</user>
		<password>password</password>
		<context>4</context>
	</auth>
	<task>
		<code>0110005</code>
		<view>
			<children>1</children>
			<offset>0</offset>
			<limit>10</limit>
		</view>
		<where>
			<and>
				<key>tld</key>
				<operator>like</operator>
				<value>web</value>
			</and>
		</where>
		<key>adminc</key>
		<key>nserver</key>
		<key>owner</key>
		<key>ownerc</key>
		<key>techc</key>
		<key>zonec</key>
		<key>phase</key>
		<order>
			<key>created</key>
			<mode>asc</mode>
		</order>
	</task>
</request>
```

```
<response>
	<result>
		<data>
			<summary>1</summary>
			<domain_prereg>
				<name>example1.web</name>
				<ownerc>199563</ownerc>
				<adminc>199563</adminc>
				<techc>199563</techc>
				<zonec>199563</zonec>
				<nserver>
					<name>ns1.example.com</name>
				</nserver>
				<nserver>
					<name>ns2.example.com</name>
				</nserver>
				<status>PENDING</status>
				<phase>sunrise1</phase>
				<order_reference>1c3d6112-c4ac</order_reference>
				<prereg_config>
					<confirmation_start>2013-01-24 00:00:00</confirmation_start>
					<confirmation_end>2044-12-24 00:00:00</confirmation_end>
					<period_start>2013-01-24 00:00:00</period_start>
					<period_end>2014-01-24 00:00:00</period_end>
				</prereg_config>
				<owner>
					<user>customer</user>
					<context>4</context>
				</owner>
				<updated>2013-10-09 12:36:58</updated>
			</domain_prereg>
		</data>
        <status>
            <code>S0110005</code>
            <text>Preregistration data were inquired successfully.</text>
            <type>success</type>
        </status>
	</result>
    <stid>20131226-app-82085</stid>
</response>
```