---
title: "Contact Erweiterungen(Extensions)"
url: "https://help.internetx.com/de/api/core-contact-erweiterungen-extensions/"
lang: "de"
section: "API-Referenz — API-Referenz (XML/JSON)"
breadcrumb: "API-Dokumentation (XML/ JSON) > Objekte"
updated: "2026-02-23"
---

# Contact Erweiterungen(Extensions)

## 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](/de/api/core-addon-update-mode-enum/) | 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.<br>Mögliche Werte:<br>• PENDING  = Verifizierung in Bearbeitung<br>• SUCCESS  =  Verifizierung erfolgreich<br>• FAILED = Verifizierung fehlgeschlagen<br>• 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](/de/api/core-gender-enum/) | Geschlecht<br>• MALE<br>• FEMALE<br>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](https://tools.ietf.org/html/rfc3066) z.B. "de" oder "de\_ch" |
| mobilePhone | mobile\_phone | 0 - 1 | string | phone | Mobile Telefonnummer<br>Format: +49-123-123 |
| strict | strict | 0 - 1 | boolean |  | Stellt sicher, dass die Daten für die Übertragung zur Registry nicht verändert werden.<br>0 = nicht aktiv<br>1 = aktiv<br>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](http://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)](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](/de/api/core-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](/de/api/core-aueligibilitytypeconstants/) | Berechtigter Organisationstyp des Registranten |
| policyReason | au\_policy\_reason | 0 - 1 | enum | [AuPolicyReasonConstants](/de/api/core-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](/de/api/core-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](/de/api/core-ciracprconstants/) | (= Canadian Presence Requirements)<br>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?<br>Werte:<br>• Yes = die Person ist 18 Jahre alt oder älter<br>• No = die Person ist jünger als 18<br>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](/de/api/core-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](/de/api/core-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.<br>Mögliche Werte:<br>• COM - für irische Firmen mit CRO-Nummer<br>• OTH - Person oder Organisation ohne CRO-Nummer |
| ieSupportingNumber | ie\_supporting\_number | 0 - 1 | string |  | Für irische Inhaber:<br>• 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.<br>Nicht-irische Inhaber:<br>• Die allgemeine Kontakt-Erweiterung "trademark" verwenden. Siehe oben "Allgemeine Kontakt-Erweiterungen".<br>Alternative zu den zwei obigen Möglichkeiten:<br>• 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](/de/api/core-itentitytypeconstants/) | Gruppe, der der Kontakt angehört.<br>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.<br>• 0 = Nein<br>• 1 = Ja<br>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.<br>• 0 = Nein<br>• 1 = Ja<br>Vorgabewert = 0 |
| industryClass | jobs\_industry\_class | 0 - 1 | const | [JobsIndustryClassConstants](/de/api/core-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 | Format | Beschreeibung |
| --- | --- | --- | --- | --- | --- |
| first | jp\_fname\_b64 | 0 - 1 | string |  | Vorname.<br>Es müssen japanische Buchstaben verwendet werden. |
| last | jp\_lname\_b64 | 0 - 1 | string |  | Nachname.<br>Es müssen japanische Buchstaben verwendet werden. |
| organization | jp\_organization\_b64 | 0 - 1 | string |  | Organisation.<br>Es müssen japanische Buchstaben verwendet werden. |
| adressLine1 | jp\_address1\_b64 | 0 - 1 | string |  | Erste Zeile der Adresse.<br>Es müssen japanische Buchstaben verwendet werden. |
| adressLine2 | jp\_address2\_b64 | 0 - 1 | string |  | Zweite Zeile der Adresse.<br>Es müssen japanische Buchstaben verwendet werden. |
| adressLine3 | jp\_address3\_b64 | 0 - 1 | string |  | DritteZeile der Adresse.<br>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.<br>• 0 = Kontaktinformationen werden nicht ausgeblendet<br>• 1 = Kontakt-Informationen werden ausgeblendet<br>Vorgabewert = 0<br>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](/de/api/core-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:<br>• in Deutsch UID, die "Unternehmens-ID",<br>• in Französisch IUDE,  die "Numéro d’identification des entreprises" und<br>• in Italienisch IDI, die "Numero d’identificazione delle imprese".<br>Für natürliche Personen:<br>• 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](/de/api/core-uktypeconstants/) | Organisationstyp für Kontakte.<br>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.<br>0 = keine öffentliche Körperschaft1 = öffentliche Körperschaft<br>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. |