Table of Contents

Description

The Domain object represents the domain.

Structure

Keyword JSON

Keyword XML

Occurs

Type

Format

Description

abuseEmail


0 - 1

string


Deprecated

action


0 - 1

Enum


Deprecated

adminc

adminc

0 - 1*)

integer/object

int32/Contact

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

Example with ID:

JSON:
"adminc":{"id":100000}

XML:
<adminc>100000</adminc>

Example with a new contact (no ID):

JSON: "adminc":{ "fname":"john", "lname":"doe", //... }

XML: <adminc>

<fname>john</fname>

<lname>doe</lname>
<!-- ... -→
</adminc>

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_job0 - 1object

DNSSecJob

Contains the information about a running AutoDnsSec job.

autoRenewStatus

autorenew

0 - 1

enum

AutoRenewStatus
Constants

Describes the status of the domain during the automatic runtime prolongation (AutoRenew).

cancelationStatus

cancelation0 - 1

enum

CancelationStatus
Constants

Describes the status of the domain at cancellation.

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 not 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 of creation.

dnssec

dnssec

0 - n

object

DNSSEC

Indicates whether DNSSEC is enabled for the domain or not. Transferring the key material to the registry and removing it from the registry.

dnssecData

dnssec0 - nobjectDNSSEC

Submits the key material to the registry. If the list is empty, the key material is deleted at the registry. If the key is omitted during an update, the data is retained.

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

The expire date of the domain at the registry

generalRequestEmailgeneral_request_email0 - 1string
Deprecated

parkingExtensions

extension

0 -1

object


Deprecated

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.

In JSON the behavior is set via the query parameter "ignoreWhois", e.g. "?ignoreWhois".

includeWildcard

include_wildcard0 -1

boolean


Activate the IncludeWildcard function.

Possible values:

  • false = inactive
  • true = active

Default value = false

For XML, 0 (false) and 1 (true) can also be used.

includeWWW

www_include0 - 1

boolean


Activate the IncludeWWW function when creating the zone. Only applies to DomainCreate and DomainTransfer.

Possible values:

  • false = inactive
  • true = active

Default value = false

For XML, 0 (false) and 1 (true) can also be used.

If an Ip address is entered in the "mainIP" field, the www record is created on the name server.

logId

log_id0 - 1

integer64


The identifier 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

?nsCheck=ALL

nscheck

0 - 1

enum

DNSCheck

Additional name server check is performed. Before the domain operation is executed.

In JSON by query parameter: ?nsCheck=ALL

owner

owner

0 - 1



The object owner.

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

The date on which the domain will be billed the next time

The billing date can be queried with the DomainInfo task.

period

period

0 - 1*)

integer

int64

Registration period.

Default value is the minimum term. The period is automatically extended.

priceClass

price_class

0 - 1

string


Price class. Required for premium domains.

The price class can be inquired by the DomainPremiumList or DomainPremiumInfo task.

priceClassRenew

price_class_renew0 - 1

string


The price class to be used for the Domain 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 Privacy Plus email. With WHOIS Privacy Plus, an individual email address is generated for each domain.

rddsOptIn

rdds_opt_in0 - 1

enum

RddsOptInConstants

Controls the information to be displayed in Whois. Currently only NOT_SET and ALL are supported.

registrarStatus

registrar_status0 - 1

enum

RegistryStatus
Constants

Status of the domain at the registry.

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

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


Enable trustee service for the domain.

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 the 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.

Possible 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
object for XML, for JSON Zone object.

Zone settings for the domain.
(DNS settings)

zonec

zonec

0 - 1*)

integer/object

int32/Contact

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


overwrite_authinfo

0 - 1

boolean


Overwrite the AuthInfo when updating the domain.

Possible values:

  • false = AuthInfo is not overwritten. An existing AuthInfo is kept.
  • true = The AuthInfo is replaced by a new one.

Default value = false

For XML, 0 (false) and 1 (true) can also be used.


Not usable for TLDs whose registry does not support updating the AuthInfo via a domain update (e.g. Denic)