Help Center
Login Sign up
  1. Home
  2. API reference
  3. API documentation (JSON/XML)
  4. Objects

Domain restore object (JSON) restore object (XML)

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

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.

actionaction0 - 1enum
Deprecated
admincadminc0 - 1*)integer/objectint32/Contact

Domain contact ID of the administrative contact person or complete <contact> - block

authInfo
0 - 1string

The AuthInfo for a transfer

autoDnsSecuse_auto_dnssec0 - 1boolean

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.

autodnsSecJobauto_dnssec_job0 - 1objectDNSSecJob

Contains the information about a running AutoDnsSec job.

autoRenewStatusautorenew0 - 1enum

AutoRenewStatus
Constants

Describes the status of the domain during the automatic runtime extension (AutoRenew)

cancelationStatuscancelation0 - 1enum

CancelationStatus
Constants

Describes current cancelation status of the domain.
commentcomment0 - 1string

Domain comments.

Updates (JSON) only via:
PUT /domain/{name}/_comment.

The user needs the appropriate ACLs.

confirmOrderconfirm_order0 - 1boolean

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.

confirmOwnerConsentconfirm_owner_consent0 - 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 - 1stringdate-time

Date on which the restore object was created.

deleteddeleted0 -1stringdate-timeCancelation date

dnssec

dnssec

0 - n

object

DNSSEC

Transfering  the key material to the registry and removing it from the registry.

dnssecData

dnssec0 - nobjectDNSSEC

The DNSSEC Data

domainCreateddomain_created0 - 1stringdate-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

Additional data required by some registries.
generalRequestEmailgeneral_request_email0 - 1string
Email address
idn
0 - 1string

Is set if the domain is an IDN domain and the domain name is written in UTF-8, e.g. müller.de.

ignoreWhoisignore_whois0 - 1boolean

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_id0 - 1numberinteger64

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_group0 - 1

string


The name server group, which could be determined from the name servers.

nameServers

nserver

0 - 8*)

object

NameServer

Nameserver

nicMemberLabelnic_member_label0 - 1string

The  NIC Member Label

owner

owner

0 - 1

The owner of the object

ownerc

ownerc

0 - 1*)

integer/object

int32/Contact

Domain contact ID of the domain owner or complete <contact> - Block

parking

parking

0 - 1

enum

ParkingProvider
Constants

Deprecated

payable

payable

1

string

date-time

Current billing date of the domain

The billing date can be queried with the DomainInfo 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_renew0 - 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  task enquires the corresponding TLDs.

privacyPlus

use_privacy_plus0 - 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_email0 - 1

string


The PrivacyPlus email

rddsOptIn

rdds_opt_in0 - 1

enum

RddsOptInConstants

Specifies the Whois output.

registrarStatus

registrar_status0 - 1

enum

RegistryStatus
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

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

restorePhaseEndend_of_phase0 - 1stringdate-time

The end of the current restore phase.

servicesAdd

services_add0 - 1

enum

DomainServices

Add Domain Services

servicesRem

services_rem0 - 1

enum

DomainServices

Remove Domain Services

techc

techc

0 - 1*)

integer/object

int32/Contact

Domain contact ID of the technical contact or complete <contact> - Block

tmchClaimsNoticeExtensions
0 - 1objectDomainTMCHClaim
NoticeExtensions
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

User who performed the last update

validCertificate

certificate0 - 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 (XML)
Zone (JSON).

Zone settings for the domain.

zonec

zonec

0 - 1*)

integer/object

int32/Contact

Domain contact ID of the ZoneC or complete  <contact> –block.

Usage