---
title: "Notify Object"
url: "https://help.internetx.com/en/api/core-notify-object/"
lang: "en"
section: "API reference — API reference (XML/JSON)"
breadcrumb: "API documentation (JSON/XML) > Objects > XML specific objects"
updated: "2023-10-25"
---

# Notify Object

## Description

The _Notify_ object represents the notification in a system reponse. Depending on the notification type, it contains objects with the required data. It is used only for XML.

Information about asynchronous notifications you find here.

Notification Types:

-   transfer\_start = A transfer was started.
-   transfer\_autoack = The domain transfer was automatically confirmed (AutoAck). Only for gTLDs.
-   transfer\_autonack = The domain transfer was automatically rejected (AutoNack).
-   transfer\_reminder = Reminder of an ongoing transfer.
-   transfer\_autonack\_pending = The transfer with AutoAck is still pending.
-   transfer\_autonack\_success = The transfer with AutoNack was successful.
-   transfer\_autonack\_failed = The transfer with AutoNack failed.
-   transfer\_autoack\_success = The transfer with AutoAck was successful.
-   transfer\_autoack\_failed = The transfer with AutoAck failed.
-   domain\_away = The domain was deleted from the inventory, e.g. for transfers without involving the registrar.
-   domain\_expire = The registration period of the domain has expired.
-   domain\_expire\_warning = The domain's registration period is about to expire.
-   domain\_registrar\_status\_update = The status has been updated at the registrar.
-   domain\_deactivation\_warning = The domain will be deactivated soon.
-   authinfo\_deleted = The AuthInfo has been deleted.
-   authinfo\_delete = The AuthInfo deletion was started.
-   tmch\_status\_update\_success = The marker update was successful.
-   tmch\_status\_update\_failed = The marker update failed.
-   tmch\_status\_update = The update of the marker was started.
-   tmch\_claim\_notice\_reminder = Reminder of pending confirmation for a trademark domain.
-   domain\_prereg\_failed = Domain preregistration failed.
-   domain\_prereg\_decline = Pre-egistration of the domain has been rejected.
-   domain\_prereg\_accept = The preregistration of the domain was accepted.
-   domain\_prereg\_sent = The preregistration of the domain was sent.
-   autoupdate\_dns\_success = The update to the name server was successful.
-   autoupdate\_dns\_error = The update to the name server failed.
-   autoupdate\_deferred\_success = The domain update was successful.
-   autoupdate\_deferred\_error = The update to the domain data failed.
-   contact\_deleted = The contact was deleted.
-   user\_activated = The user was activated.
-   ocval\_start = The verification was started.
-   ocval\_confirmed = The verification was confirmed.
-   zone\_delete = The zone has been deleted.

### Structure

| Keyword XML | Occurs | Type | Format | Description |
| --- | --- | --- | --- | --- |
| type | 1 | string |  | Notification type (see list above) |
| domain | 0 - 1 | object | [Domain](/en/api/core-domain-object/) | Domain object |
| zone | 0 - n | object | [Zone](/en/api/core-zone-object/) | Zone object |
| user | 0 - 1 | object | [User](/en/api/core-user-object/) | User object |
| handle | 0 - 1 | object | [Contact](/en/api/core-contact-object/) | Domain contact object |
| handle\_verification | 0 - 1 | object | ContactVerification | Domain contact verification object |
| domain\_prereg | 0 - 1 | object | Domain\_Prereg | Preregistration object |
| transfer | 0 - 1 | object | [Transfer](/en/api/core-transfer-object-out/) | Extended information on transfers or ownerchanges. |
| answer | 0 - 1 | enum | [Transfer\_Type](/en/api/core-transfer-type-enum/) | Contains the response to the transfer, the confirmation or rejection. Can only occur if a transfer object also exists, but does not have to. |
| reason | 0 - 1 | string |  | Depends on the notification type:<br>• domain\_deactivation\_warning = reason for domain deactivation.<br>• domain\_registrar\_status\_update = reason for domain update. |
| deactivation | 0 - 1 | string | datetime | Point of time when the domain will be deactivated. Only for domain\_deactivation\_warning notification type. |
| registrar\_status | 0 - 1 | enum | [RegistryStatusConstants](/en/api/core-registry-status-constants/) | New status of the domain at the registrar. Only for domain\_registrar\_status\_update notification type. |
| msg | 0 - 1 | object | Msg | Contains other message objects that occurred during processing. |
| status | 1 | object | [Status](/en/api/core-status-object/) | Status object |

### XML Example

```
<notify>
	<domain>
		<name>exampledomain.aq</name>
		<ownerc>23252437</ownerc>
		<adminc>23252437</adminc>
		<techc>23252437</techc>
		<zonec>23252437</zonec>
		<nic_member_label>AQ-TEST</nic_member_label>
		<registry_status>ACTIVE</registry_status>
		<nserver>
			<name>ns1.examplenameserver.com</name>
		</nserver>
		<nserver>
			<name>ns2.examplenameserver.com</name>
		</nserver>
		<ip>1.2.3.4</ip>
		<period>1</period>
		<action>AUTOUPDATE_DEFERRED</action>
		<autorenew>true</autorenew>
		<registrar_status>ACTIVE</registrar_status>
		<rdds_opt_in>NOT_SET</rdds_opt_in>
		<owner>
			<user>normal_user</user>
			<context>4</context>
		</owner>
		<updater>
			<user>normal_user</user>
			<context>4</context>
		</updater>
		                   
		<created>2021-05-07 15:38:31</created>
	</domain>
	<type>autoupdate_deferred_error</type>
	<status>
		<code>E0102</code>
		<type>error</type>
	</status>
	<stid>20210507-app2-dev-19938</stid>
	<created>2021-05-07 15:39:13</created>
</notify>            
```