--- title: "Domain restore object (JSON) restore object (XML)" url: "https://help.internetx.com/en/api/core-domain-restore-object-json-restore-object-xml/" lang: "en" section: "API reference — API reference (XML/JSON)" breadcrumb: "API documentation (JSON/XML) > Objects" updated: "2023-09-25" --- # Domain restore object (JSON) restore object (XML) ## Description The _Restore_ (XML) or _DomainRestore_ (JSON) object maps a domain to be restored. ## Structure | **Keyword JSON** | **Keyword XML** | **Occurs** | **Type** | **Format** | **Description** | | --- | --- | --- | --- | --- | --- | | abuseEmail | | 0 - 1 | string | | The email address for abuse emails. | | action | action | 0 - 1 | enum | | Deprecated | | adminc | adminc | 0 - 1\*) | integer/object | int32/[Contact](/en/api/core-contact-object/) | Domain contact ID of the administrative contact person or complete - block | | authInfo | | 0 - 1 | string | | The AuthInfo for a transfer | | autoDnsSec | use\_auto\_dnssec | 0 - 1 | boolean | | Enables or disables the use of DNSSEC.
Possible values:
• false = deactivates DNSSEC
• true = activates DNSSEC
Default value = false
For XML, 0 (false) and 1 (true) can also be used.
This keyword can only be used if the system manages DNSSEC completely. This only works for certain name servers, e.g. NodeSecure.
To manage only the key material, use the keyword DNSSEC. | | autodnsSecJob | auto\_dnssec\_job | 0 - 1 | object | DNSSecJob | Contains the information about a running AutoDnsSec job. | | autoRenewStatus | autorenew | 0 - 1 | enum | [AutoRenewStatus Constants](/en/api/core-auto-renew-status-constants/) | Describes the status of the domain during the automatic runtime extension (AutoRenew) | | cancelationStatus | cancelation | 0 - 1 | enum | [CancelationStatus Constants](/en/api/core-cancelation-status-constants/) | Describes current cancelation status of the domain. | | comment | comment | 0 - 1 | string | | Domain comments.
Updates (JSON) only via: PUT /domain/{name}/\_comment.
The user needs the appropriate ACLs. | | confirmOrder | confirm\_order | 0 - 1 | boolean | | Some TLDs require the confirmation of the registration conditions.
Possible values:
• false = Do nor confirm conditions
• true = Confirm conditions
Default value = false
For XML, 0 (false) and 1 (true) can also be used. | | confirmOwnerConsent | confirm\_owner\_consent | 0 - 1\*) | boolean | | Confirmation of the domain holder's agreement to changes. Required for gTLDs and new gTLDs when changing the name, email address or organization of the domain holder.
Possible values:
• false oder empty = Agreement is not given. Consequence:   The request is not accepted
• true= Agreement is given
Default value = false
For XML, 0 (false) and 1 (true) can also be used.
The confirmation is required since 07.12.2016 due to the new ICANN owner change procedure. | | created | | 0 - 1 | string | date-time | Date on which the restore object was created. | | deleted | deleted | 0 -1 | string | date-time | Cancelation date | | dnssec | dnssec | 0 - n | object | [DNSSEC](/en/api/core-dnssec-object/) | Transfering  the key material to the registry and removing it from the registry. | | dnssecData | dnssec | 0 - n | object | [DNSSEC](/en/api/core-dnssec-object/) | The DNSSEC Data | | domainCreated | domain\_created | 0 - 1 | string | date-time | Date on which the domain was registered at the registry. | | domainsafe | domainsafe | 0 - 1 | boolean | | Activate DomainSafe
• false = domain is not in the domainsafe
• true= domain is in the domainsafe
Default value = false
For XML, 0 (false) and 1 (true) can also be used. | | expire | | 0 - 1 | string | date-time | Expiring date of the domain at the registry. | | extensions | | | object | [DomainExtensions](/en/api/core-domain-extensions-object-json-domain-addons-object-xml/) | Additional data required by some registries. | | generalRequestEmail | general\_request\_email | 0 - 1 | string | | Email address | | idn | | 0 - 1 | string | | Is set if the domain is an IDN domain and the domain name is written in UTF-8, e.g. müller.de. | | ignoreWhois | ignore\_whois | 0 - 1 | boolean | | Avoid availability query
Possible values:
• false= Whois is not ignored
• true = Whois is ignored
Default value = false
For XML, 0 (false) and 1 (true) can also be used. | | logId | log\_id | 0 - 1 | number | integer64 | Log ID that is required for the _DomainHistoryInfo_ task. | | name | name | 1 | string | domain | Name of the domain | | nameServerEntries | nsentry | 0 - 5\*) | string | | Nsentry entry. For .de domains only. If nsentry is used, the request must not contain an nserver.
For bulk requests, specify nsentry in the "Default" block, the domain must then be replaced with the placeholder {domain}. | | nameServerGroup | ns\_group | 0 - 1 | string | | The name server group, which could be determined from the name servers. | | nameServers | nserver | 0 - 8\*) | object | [NameServer](/en/api/core-name-server-object/) | Nameserver | | nicMemberLabel | nic\_member\_label | 0 - 1 | string | | The  NIC Member Label | | owner | owner | 0 - 1 | | | The owner of the object | | ownerc | ownerc | 0 - 1\*) | integer/object | int32/[Contact](/en/api/core-contact-object/) | Domain contact ID of the domain owner or complete - Block | | parking | parking | 0 - 1 | enum | [ParkingProvider Constants](/en/api/core-parking-provider-constants/) | Deprecated | | payable | payable | 1 | string | date-time | Current billing date of the domain
The billing date can be queried with the [DomainInfo](/en/api/core-domain-info/) task. | | period | period | 0 - 1\*) | integer | int64 | Registration period.
The default value is the minimum registration period. The runtime is automatically extended. | | priceClassRenew | price\_class\_renew | 0 - 1 | string | | Priceclass for Renew | | privacy | use\_privacy | 0 - 1 | boolean | | Use of the Whois Privacy Service, which prevents your contact information from being displayed in the public Whois of the domain.
Possible values:
• false = Whois Privacy Service is not used
• true = Whois Privacy Service is used
Default value = false
For XML, 0 (false) and 1 (true) can also be used.
Optional and limited to certain TLDs. The [DomainInfo](/en/api/core-domain-info/)  task enquires the corresponding TLDs. | | privacyPlus | use\_privacy\_plus | 0 - 1 | boolean | | Activate PrivacyPlus.
Possible values:
• false = PrivacyPlus ist not activated
• true = PrivacyPlus is activated
Default value = false
For XML, 0 (false) and 1 (true) can also be used. | | privacyPlusMail | privacy\_plus\_email | 0 - 1 | string | | The PrivacyPlus email | | rddsOptIn | rdds\_opt\_in | 0 - 1 | enum | [RddsOptInConstants](/en/api/core-rdds-optin-constants/) | Specifies the Whois output. | | registrarStatus | registrar\_status | 0 - 1 | enum | [RegistryStatus Constants](/en/api/core-registry-status-constants/) | Status of the domain at the registrar. | | registrarStatusReason | registrar\_status\_reason | 0 - 1 | string | | Reason for the set status of the domain at the registrar. | | registryStatus | registry\_status | 0 - 1 | enum | [RegistryStatus Constants](/en/api/core-registry-status-constants/) | Sets the status of the domain after the "Create" process. | | removeCancelation | remove\_cancelation | 0 - 1 | boolean | | If the domain is renewed, a cancelation reqest can be deleted at the same time.
Possible values:
• false = The cancelation request is not deleted.
• true = The cancelation request is deleted.
Default value = false
For XML, 0 (false) and 1 (true) can also be used.
If a cancelation order exists and "0" is set, the renew fails.
In JSON, the flag can be used as a query parameter:
`?removeCancelation` | | restorePhaseEnd | end\_of\_phase | 0 - 1 | string | date-time | The end of the current restore phase. | | servicesAdd | services\_add | 0 - 1 | enum | [DomainServices](/en/api/core-domain-services-object/) | Add Domain Services | | servicesRem | services\_rem | 0 - 1 | enum | [DomainServices](/en/api/core-domain-services-object/) | Remove Domain Services | | techc | techc | 0 - 1\*) | integer/object | int32/[Contact](/en/api/core-contact-object/) | Domain contact ID of the technical contact or complete - Block | | tmchClaimsNoticeExtensions | | 0 - 1 | object | [DomainTMCHClaim NoticeExtensions](/en/api/core-domain-tmch-claim-notice-extensions/) | TMCH extensions | | trustee | use\_trustee | 0 - 1 | boolean | | Usage of Trustee service
Possible values:
• false = Trustee service  is not used
• true = Trustee service  is used
Default value = false
For XML, 0 (false) and 1 (true) can also be used. | | updated | updated | 0 - 1 | string | date-time | Date of last update. | | updater | updater | 0 - 1 | object | [Basic User](/en/api/core-basic-user-object/) | User who performed the last update | | validCertificate | certificate | 0 - 1 | boolean | | There is a suitable certificate for the domain.
Possile values:
• false = No certificate
• true = There is a certificate
Default value = false
For XML, 0 (false) and 1 (true) can also be used. | | zone | zone | 1 | object | [Domain Zone](/en/api/core-domain-zone-object/) (XML) [Zone](/en/api/core-zone-object/) (JSON). | Zone settings for the domain. | | zonec | zonec | 0 - 1\*) | integer/object | int32/[Contact](/en/api/core-contact-object/) | Domain contact ID of the ZoneC or complete  –block. | ### Usage - [Domain Restore List](/en/api/core-domain-restore-list/)