Suche in diesem Bereich

Skip to end of metadata
Go to start of metadata
Table of Contents

Description

The Contact (Previously Handle) object represents the contact information required for domains.

Note on Migration from XML to JSON

Most XML keywords separated by underscores are written in JSON in CamelCase, starting with a lowercase letter.

Example:

confirm_order becomes confirmOrder
price_class becomes priceClass

Some keywords have been simplified in addition to spelling changes.

Example:

use_auto_dnssec becomes autoDnsSec.

Structure

Keyword JSONKeyword XMLOccursTypeFormatDescription
address

address

1 - 3

string


Street. Depending on the registry, up to 65,536 characters may be possible.

alias

alias

0 - 1string
Self-defined character string that uniquely identifies the domain contact.
city

city

1

string


City

comment

comment

0 - 1

string


Domain contact comment, solely ASCII characters

confirmOwnerConsent

confirm_owner_consent

1

boolean


Confirmation of the domain holder that he agrees to the changes.

  • 1= Confirm
  • 0 or blank= refuse confirmation; order will not be accepted

Default value = 0

This confirmation has been required since December 7, 2016 due to ICANN's new change of ownership procedure for changes to the domain holder's name, email address or organization. Only for gTLDs and new gTLDs.

country

country

1

string


Country (ISO 3166-1 alpha-2) Country Code
Certain strings, such as "Germany", are mapped to DE.

createdcreated0 - 1stringdate-timeDate the contact was created on.
domainsafedomainsafe0 - 1boolean
Indicates whether the domain contact is in the DomainSafe.
email

email

0 - 1*)

string

email

Email address

extensionsextension0 - 1object

Contact Extensions

Additional data for contacts required by several TLDs
fax

fax

0 - 1*)

string

phone

Fax number e.g. +49-123-123

fname

fname

1

string


First name

id

id

0 - 1

string


Domain contact Id

lname

lname

1

string


Last name

nicRef

nic_ref

0 - n

string


Manually create a NIC reference for the domain contact. This is not required, since the NIC references are always created automatically.

This will no longer be supported in the future.

organization

organization

1

string


Organization

ownerowner
objectBasicUserUser, the object belongs to
pcode

pcode

1

string


Postal code

phone

phone

0 - 1*)

string

phone

Phone number e.g. +49-123-123

protection

protection

1

enum

ContactProtection

Data shown in the Whois.

remarks

remarks

0 - n

string


Comment shown in the Whois. Nur für .de.

state

state

0 - 1

string


state

title

title

0 - 1

string


Titel

type

type

1

enum

ContactTypeEnum

Domain contact type

verificationverification0 - 1enumGenericStatusEnum

The status of domain contact verification.

  • SUCCESS: Domain contact verification successful
  • PENDING: Domain contact verification in progress
  • FAILED: Domain Contact Verification failed
  • NOT_SET: Domain contact verification not started

*) Depends on the respective registry

Usage