Start
/
API-Referenz
/
API-Dokumentation (XML/ JSON)
/
Objekte

Contact Erweiterungen(Extensions)

API-Referenz (XML/JSON) · Aktualisiert 2026-02-23

Beschreibung

Einige TLDs fordern für die Registrierung von Domains zusätzliche Angaben für die Domain-Kontakte. Diese werden über Erweiterungen (extensions) angegeben.

Alle Erweiterungen

Allgemeine Erweiterungen

JSON Keyword	XML Keyword	Häufigkeit	Typ	Format	Beschreibung
-	mode	0 - 1	enum	AddonUpdateMode	Dieses Keyword beeinflusst, wie die zusätzlichen Angaben bei der Aktualisierung behandelt werden. Nur für ContactUpdate möglich.
-	verification	0 - 1	enum		Verifizierungsstatus des Kontaktes. Mögliche Werte: PENDING = Verifizierung in Bearbeitung SUCCESS = Verifizierung erfolgreich FAILED = Verifizierung fehlgeschlagen NOT_SET = nicht gesetzt
citizenship	citizenship	0 - 1	string		Staatsangehörigkeit. Für EU-Bürger die außerhalb der EU wohnen
birth.country	birthcountry	0 - 1	string		Geburtsland (ISO 3166 Country Code)
birth.day	birthday	0 - 1*)	string	date	Geburtstag (yyyy-MM-dd)
birth.postalCode	birthpcode	0 -1*)	string		Postleitzahl des Geburtsortes
birth.place	birthplace	0 - 1*)	string		Geburtsort
companyNumber	companynumber	0 - 1*)	string		Handelsregisternummer/ Firmennummer
gender	gender	0 - 1*)	enum	Gender	Geschlecht MALE FEMALE Vorgabewert “ ”
vatNumber	vatnumber	0 - 1*)	string		Umsatzsteuernummer
identification.authority	id_authority	0 - 1*)	string		Ausstellende Behörde des Personalausweises.
identification.dateOfIssue	id_date_of_issue	0 - 1*)	string	date	Datum, an dem der Ausweis ausgestellt wurde.
identification.number	idnumber	0 - 1*)	string		Personalausweisnummer.
identification.validTill	id_valid_till	0 - 1*)	string	date	Datum, an dem die Gültigkeit des Personalausweises abläuft.
language	language	0 - 1	string		Sprache des Kontaktes RFC 3066 z.B. "de" oder "de_ch"
mobilePhone	mobile_phone	0 - 1	string	phone	Mobile Telefonnummer Format: +49-123-123
strict	strict	0 - 1	boolean		Stellt sicher, dass die Daten für die Übertragung zur Registry nicht verändert werden. 0 = nicht aktiv 1 = aktiv Vorgabewert= 0
trademark.appdate	trademark_appdate	0 - 1*)	string	date	Antragsdatum der Marke (yyyy-MM-dd)
trademark.country	trademark_country	0 - 1*)	string		Land, in dem die Marke gültig ist (ISO 3166 Country Code).
trademark.name	trademark_name	0 - 1*)	string		Markenname
trademark.number	trademark_number	0 - 1*)	string		Markennummer
trademark.office	trademark_office	0 - 1*)	string		Das Markenamt, bei dem die Marke eingetragen ist.
trademark.regdate	trademark_regdate	0 - 1*)	string	date	Eintragungsdatum der Marke

^{*) Ist abhängig von der jeweiligen Registry.}

.aero

Eine .aero-Domain kann man registrieren, wenn man eine ENS Auth ID und einen ENS Key hat (Link zum Beantragen einer .aero-ID https://www.information.aero/node/add/request-aero-id)

JSON Keyword	XML Keyword	Häufigkeit	Typ	Format	Beschreibung
ensAuthId	aero_ens_auth_id	0 - 1	string		Aero Authentifizierungs-ID
ensKey	aero_ens_key	0 - 1	string		Aero ENS key

.au

JSON Keyword	XML Keyword	Häufigkeit	Typ	Format	Beschreibung
eligibilityId	au_eligibility_id	0 - 1	integer	int32	Die ID-Nummer für die Angabe bei "Policy Reason" wenn zutreffend. Im Zweifelsfall die gleiche Angabe wie bei Registrant-ID.
eligibilityIdType	au_eligibility_id_type	0 - 1	enum	AuEligibilityIdTypeConstants	Bezieht sich auf die Eligibility-ID, die du angegeben hast.
eligibilityName	au_eligibility_name	0 - 1	string		Dieses Feld ist in der Regel optional. Dies ist abhängig vom ausgewählten Grund der Berechtigung (Policy Reason). Im Zweifelsfall hier die gleichen Angaben wie für den Namen des Registranten eingeben.
eligibilityType	au_eligibility_type	0 - 1	enum	AuEligibilityTypeConstants	Berechtigter Organisationstyp des Registranten
policyReason	au_policy_reason	0 - 1	enum	AuPolicyReasonConstants	Grund für die Berechtigung
registrantId	au_registrant_id	0 - 1	integer	int32	"Australian Business Number" oder "Registered Business Number"
registrantIdType	au_registrant_id_type	0 - 1	enum	AuRegistrantIdTypeConstants	Betrifft die Registrant-ID, die du im Feld Registrant-ID angegeben hast.
registrantName	au_registrant_name	0 - 1	string		Name des Registranten

.bank

JSON Keyword	XML Keyword	Häufigkeit	Typ	Format	Beschreibung
ftldToken	ftld_token	0 - 1	integer	int32	Registrierungs-Token, den du nach erfolgreicher Verifizierung durch die Registry per E-Mail erhalten hast. Die Eingabe ist erforderlich.

.barcelona

JSON Keyword	XML Keyword	Häufigkeit	Typ	Format	Beschreibung
intendedUse	barcelona_intended_use	0 - 1	string		Die beabsichtigte Nutzung der Domain.

.ca

JSON Keyword	XML Keyword	Häufigkeit	Typ	Format	Beschreibung
cpr	cpr_category	1	enum	CiraCprConstants	(= Canadian Presence Requirements) Angabe des Grundes für die Berechtigung eine .ca Domain zu registrieren.
officialRepresentative	cira_official_representative	0 - 1	string		Gesetzlicher Vetreter
trusteePercentage	circa_trustee_percentage	0 - 1	number	double	Anteil der Kanadier in einem Trust. Wert muss <= 66 sein. Verpflichtend wenn CPR = TRS (Trust).

JSON Keyword

XML Keyword

Häufigkeit

Typ

Format

Beschreibung

cpr

cpr_category

enum

CiraCprConstants

(= Canadian Presence Requirements)

Angabe des Grundes für die Berechtigung eine .ca Domain zu registrieren.

officialRepresentative

cira_official_representative

0 - 1

string

Gesetzlicher Vetreter

trusteePercentage

circa_trustee_percentage

0 - 1

number

double

Anteil der Kanadier in einem Trust. Wert muss <= 66 sein. Verpflichtend wenn CPR = TRS (Trust).

.cat

Eine .cat-Domain wird in einem zeitlich versetzten Prüfverfahren registriert. Als Antragsteller erhälst du eine E-Mail der Registry mit den genauen Bedingungen für die Registrierung. Wenn du dieser zustimmst wird dir die Domain vorläufig zugeteilt. Die Registry prüft dann später, ob die Domain wie angegeben verwendet wird.

JSON Keyword	XML Keyword	Häufigkeit	Typ	Format	Beschreibung
intendedUse	cat_intended_use	1	string		Beschreibung der geplanten Nutzung der Domain.

.es

Die Erweiterung dient der Weitergabe der Steuernummer an die Registry.

JSON Keyword	XML Keyword	Häufigkeit	Typ	Format	Beschreibung
identificacion	es_identificacion	1	string		Für Weitergabe der Steuernummer an die Registry

.hk

JSON Keyword	XML Keyword	Häufigkeit	Typ	Format	Beschreibung
above18	hk_above_18	0 - 1	boolean		Nur für Personen. Hat die Person das 18. Lebensjahr abgeschlossen? Werte: Yes = die Person ist 18 Jahre alt oder älter No = die Person ist jünger als 18 Vorgabewert = No
documentNumber	hk_document_number	0 - 1	string		Nummer des Dokumentes (z. B. Personalausweisnummer).
documentOrigin	hk_document_origin	0 - 1	string		Land der ausstellenden Behörde.
documentType	hk_document_type	0 - 1	enum	HkDocumentTypeConstants	Dokumentyp für Personen oder Organisationen.
others	hk_others	0 - 1	string		Zusätzliches Beschreibungsfeld für OTHIDV und OTHORG
industryType	hk_industry_type	0 - 1	enum	HkIndustryTypeConstants	Industriezweig

.ie

JSON Keyword	XML Keyword	Häufigkeit	Typ	Format	Beschreibung
contactType	ie_contact_type	1	enum		Beschreibt die Verbindung zu Irland, die für die Registrierung von Domains berechtigt. Mögliche Werte: COM - für irische Firmen mit CRO-Nummer OTH - Person oder Organisation ohne CRO-Nummer
ieSupportingNumber	ie_supporting_number	0 - 1	string		Für irische Inhaber: Kontakt-Erweiterung für .ie verwenden. Bei Keyword <ie_contact_type> (XML) bzw. in ieContactType (JSON) den Wert OTH für "Other" verwenden. Bei Keyword <ie_supporting_number (XML ) bzw. ieSupportingNumber (JSON) die irische RBN eingeben. Nicht-irische Inhaber: Die allgemeine Kontakt-Erweiterung "trademark" verwenden. Siehe oben "Allgemeine Kontakt-Erweiterungen". Alternative zu den zwei obigen Möglichkeiten: Keine Extensions mitschicken und die benötigten Nachweise in Papierform an die Registry schicken

JSON Keyword

XML Keyword

Häufigkeit

Typ

Format

Beschreibung

contactType

ie_contact_type

enum

Beschreibt die Verbindung zu Irland, die für die Registrierung von Domains berechtigt.

Mögliche Werte:

COM - für irische Firmen mit CRO-Nummer
OTH - Person oder Organisation ohne CRO-Nummer

ieSupportingNumber

ie_supporting_number

0 - 1

string

Für irische Inhaber:

Kontakt-Erweiterung für .ie verwenden.
Bei Keyword <ie_contact_type> (XML) bzw. in ieContactType (JSON) den Wert OTH für "Other" verwenden.
Bei Keyword <ie_supporting_number (XML ) bzw. ieSupportingNumber (JSON) die irische RBN eingeben.

Nicht-irische Inhaber:

Die allgemeine Kontakt-Erweiterung "trademark" verwenden. Siehe oben "Allgemeine Kontakt-Erweiterungen".

Alternative zu den zwei obigen Möglichkeiten:

Keine Extensions mitschicken und die benötigten Nachweise in Papierform an die Registry schicken

.it

JSON Keyword	XML Keyword	Häufigkeit	Typ	Format	Beschreibung
entityType	it_entity_type	0 - 1	enum	ItEntityTypeConstants	Gruppe, der der Kontakt angehört. Abhängig davon, was du bei it_entity_type eingetragen hast, müssen noch weitere Daten angegeben werden. Die Beschreibung für diese Daten findest du im Abschnitt "Allgemeine Erweiterungen".

.jobs

JSON Keyword	XML Keyword	Häufigkeit	Typ	Format	Beschreibung
adminType	jobs_admin_type	0 - 1	boolean		Hier gibst du an, ob du der Administrative Kontakt bist und die Berechtigung hast als unabhängiger Beauftragter/ Personalvermittler im Auftrag des eingetragenen Registranten tätig zu werden. 0 = Nein 1 = Ja Vorgabewert= 0
contactTitle	jobs_contact_title	0 - 1	string		Enthält den Titel des Kontaktes in der Organisation.
hrMember	jobs_hr_member	0 - 1	boolean		Hier gibst du an, ob der Kontakt Mitglied der “Human Resource Organization” ist. 0 = Nein 1 = Ja Vorgabewert = 0
industryClass	jobs_industry_class	0 - 1	const	JobsIndustryClassConstants	Die Branchenklasse, in der das Unternehmen tätig ist.e
website	jobs_website	0 - 1	string		Die URL der Website des Unternehmens.

.jp

JSON Keyword	XML Keyword	Häufigkeit	Typ	Beschreeibung
first	jp_fname_b64	0 - 1	string	Vorname. Es müssen japanische Buchstaben verwendet werden.
last	jp_lname_b64	0 - 1	string	Nachname. Es müssen japanische Buchstaben verwendet werden.
organization	jp_organization_b64	0 - 1	string	Organisation. Es müssen japanische Buchstaben verwendet werden.
adressLine1	jp_address1_b64	0 - 1	string	Erste Zeile der Adresse. Es müssen japanische Buchstaben verwendet werden.
adressLine2	jp_address2_b64	0 - 1	string	Zweite Zeile der Adresse. Es müssen japanische Buchstaben verwendet werden.
adressLine3	jp_address3_b64	0 - 1	string	DritteZeile der Adresse. Es müssen japanische Buchstaben verwendet werden.

.luxe

JSON Keyword	XML Keyword	Häufigkeit	Typ	Format	Beschreibung
walletAddress	luxe_wallet_address	0 - 1	string		Die Wallet-Adresse

.madrid

JSON Keyword	XML Keyword	Häufigkeit	Typ	Format	Beschreibung
intendedUse	madrid_intended_use	0 - 1	string		Die beabsichtigte Nutzung der Domain.

.nz

JSON Keyword	XML Keyword	Häufigkeit	Typ	Format	Beschreibung
irpo	nz_irpo	0 - 1	boolean		Ausblenden von Kontaktinformationen aus dem Whois. Betroffen sind Adresse, Telefon, Fax. 0 = Kontaktinformationen werden nicht ausgeblendet 1 = Kontakt-Informationen werden ausgeblendet Vorgabewert = 0 Nur für natürliche Personen ("Individuen") erlaubt, die den Domain-Namen nicht in nennenswertem Umfang im "Handel" verwenden, wie dies im "Fair Trading Act 1986" definiert und angewendet wird.

JSON Keyword

XML Keyword

Häufigkeit

Typ

Format

Beschreibung

irpo

nz_irpo

0 - 1

boolean

Ausblenden von Kontaktinformationen aus dem Whois. Betroffen sind Adresse, Telefon, Fax.

0 = Kontaktinformationen werden nicht ausgeblendet
1 = Kontakt-Informationen werden ausgeblendet

Vorgabewert = 0

Nur für natürliche Personen ("Individuen") erlaubt, die den Domain-Namen nicht in nennenswertem Umfang im "Handel" verwenden, wie dies im "Fair Trading Act 1986" definiert und angewendet wird.

.ro

JSON Keyword	XML Keyword	Häufigkeit	Typ	Format	Beschreibung
personType	extension /ro_person_type	0 - 1	const	RoPersonTypeConstants	Gruppe, der der Kontakt angehört.

.ru

Diese Erweiterungen werden benötigt, wenn der Inhaber eine Firma aus Russland ist (OwnerC = ORG). Ist der Inhaber eine Person werden Ausweisdaten benötigt (OwnerC = PERSON).

JSON Keyword	XML Keyword	Häufigkeit	Typ	Format	Beschreibung
taxpayerIdentificationNumber	ru_taxpayer_identification_number	0 - 1	string		Steueridentifikationsnummer (code). Für Organisationen erforderlich, die zur Russischen Föderation gehören.
territoryLinkedTaxpayerNumber	ru_territory_linked_taxpayer_number	0 - 1	string		Territoriale Steuernummer (kpp). Für Organisationen erforderlich, die zur Russischen Föderation gehören.

.scot

JSON Keyword	XML Keyword	Häufigkeit	Typ	Format	Beschreibung
intendedUse	scot_intended_use	0 - 1	string		Die beabsichtigte Nutzung der Domain.

.sport

JSON Keyword	XML Keyword	Häufigkeit	Typ	Format	Beschreibung
intendedUse	sport_intended_use	1	string		Die beabsichtigte Nutzung der Domain.

.swiss

JSON Keyword	XML Keyword	Häufigkeit	Typ	Format	Beschreibung
enterpriseId	swiss_enterprise_id	0 - 1	string		Unternehmens-ID, nach den geltenden Vorschriften für .swiss-Domains Dies sind: in Deutsch UID, die "Unternehmens-ID", in Französisch IUDE, die "Numéro d’identification des entreprises" und in Italienisch IDI, die "Numero d’identificazione delle imprese". Für natürliche Personen: Schweizer Sozialversicherungsnummer (OASI / AHV / AVS)
intendedUse	swiss_intended_use	0 - 1	string		Die beabsichtigte Nutzung der Domain.

JSON Keyword

XML Keyword

Häufigkeit

Typ

Format

Beschreibung

enterpriseId

swiss_enterprise_id

0 - 1

string

Unternehmens-ID, nach den geltenden Vorschriften für .swiss-Domains
Dies sind:

in Deutsch UID, die "Unternehmens-ID",
in Französisch IUDE, die "Numéro d’identification des entreprises" und
in Italienisch IDI, die "Numero d’identificazione delle imprese".

Für natürliche Personen:

Schweizer Sozialversicherungsnummer (OASI / AHV / AVS)

intendedUse

swiss_intended_use

0 - 1

string

Die beabsichtigte Nutzung der Domain.

.uk

Die Erweiterung <uk_type> wurde zur Kategorisierung der Organisationstypen eingeführt. Möchtest du erreichen, dass bestimmte Kontakt-Daten im Whois nicht angezeigt werden, musst du die UK-Typen IND oder FIND verwenden und bei <protection> den Wert „B“ setzen. Dies ist nicht bei allen Subdomains möglich.

JSON Keyword	XML Keyword	Häufigkeit	Typ	Format	Beschreibung
entityType	uk_type	0 - 1*)	enum	UkTypeConstants	Organisationstyp für Kontakte. Für die Subdomains ltd.uk, net.uk und plc.uk ist die Auswahl des UK Type verpflichtend. Für co.uk und me.uk ist der UK Type nicht verpflichtend

JSON Keyword

XML Keyword

Häufigkeit

Typ

Format

Beschreibung

entityType

uk_type

0 - 1*)

enum

UkTypeConstants

Organisationstyp für Kontakte.

Für die Subdomains ltd.uk, net.uk und plc.uk ist die Auswahl des UK Type verpflichtend.
Für co.uk und me.uk ist der UK Type nicht verpflichtend

*) abhängig von der Subdomain

.zuerich

JSON Keyword	XML Keyword	Häufigkeit	Typ	Format	Beschreibung
isAuthority	zuerich_is_authority	0 - 1	boolean		Gibt an, ob der Registrant eine öffentliche Körperschaft ist oder nicht. 0 = keine öffentliche Körperschaft1 = öffentliche Körperschaft Vorgabewert = 0
enterpriseId	zuerich_enterprise_id	0 - 1	string		Die Unternehmens-ID ist im spezifischen Kontext von .zuerich, gemäss den geltenden Regeln, die Schweizer UID/IDE/IDI.