Home
/
API reference
/
API documentation (JSON/XML)
/
Tasks
/
Domain prereg tasks

Domain prereg delete

API reference (XML/JSON) · Updated 2023-09-18

Function

The DomainPreregDelete task deletes a preregistration for a domain. This is possible only if the domain has one of the following statuses:

OPEN
PENDING
FAILED
AUTO_CANCEL
ACCEPT
INVALID_NAME
DECLINE
CANCEL
TMCH_CLAIM_REJECTED
TMCH_CLAIM_EXPIRED
TMCH_CLAIM_FAILED
FAILED_REF

You can delete a preregistered domain by specifying the domain name and the preregistration phase or by specifying the order reference. You can determine the order number by a DomainPreregInfo query.

Description

Route: DELETE /domainPrereg/{reference}

There is no need to send a body.

{
    "stid": "20210826-app-114113",
    "status": {
        "code": "S0110003",
        "text": "Preregistration was deleted successfully. ",
        "type": "SUCCESS"
    },
    "object": {
        "type": "DomainPrereg",
        "value": "example.web",
        "data": {
            "name": "example.web",
            "orderReference": "478f63e4-d993"
        }
    }
}

Task code: 0110003
Uses Domain Prereg object

<request>
	<auth>
		<user>customer</user>
		<password>password</password>
		<context>4</context>
	</auth>
	<task>
		<code>0110003</code>
		<domain_prereg>
			<name>example.web</name>
			<phase>sunrise2b</phase>
		</domain_prereg>
		<reply_to>customer@example.com</reply_to>
	</task>
</request>

<response>
    <result>
        <data>
            <domain_prereg>
                <order_reference>478f63e4-d993</order_reference>
            </domain_prereg>
        </data>
        <status>
            <code>S0110003</code>
            <text>Preregistration was deleted successfully.</text>
            <type>success</type>
            <object>
                <type>domain_prereg</type>
                <value>example.web</value>
            </object>
        </status>
    </result>
    <stid>20210826-app-113972</stid>
</response>