.hamburg

API commandsExtensionsRestrictions

API Commands

Please find in the following a set of the most commonly used standard API commands in order to register, modify, renew, and transfer a domain name.

AddDomainModifyDomainRenewDomainDeleteDomainTransferDomainRestoreDomain

Domain Registration

(API Command reference » AddDomain)

Exception

command         = AddDomain
domain          = yourdomain.hamburg
period          = (INT)
ownercontact0   = (CONTACT)
admincontact0   = (CONTACT)
techcontact0    = (CONTACT)
billingcontact0 = (CONTACT)
nameserver0  = (NAMESERVER)
nameserver1   = (NAMESERVER)
X-HAMBURG-ACCEPT-TRUSTEE-TAC = 0|1

After a successful registration of the domain, it will be transfer locked from the registry for a period of 60 days.

Domain Modification

(API Command reference » ModifyDomain)

Command

command = ModifyDomain
domain  = yourdomain.hamburg

Domain Renewal

(API Command reference » RenewDomain)

Command

command    = RenewDomain
domain     = yourdomain.hamburg
period     = (INT)
expiration = (INT)

Domain Deletion

(API Command reference » DeleteDomain)

Command

COMMAND = DeleteDomain
DOMAIN = yourdomain.hamburg

Domain Transfer

(API Command reference » TransferDomain)

Command

command = TransferDomain
domain = yourdomain.hamburg
action = REQUEST
auth = (TEXT)

Transfer Procedure

• The transfer is submitted to the registry and the losing registrar is automatically notified by them.
• The losing registrar sends an email to the owner (and optionally admin) contact, informing about the transfer; this may include options to approve and/or deny the transfer. If neither explicitly approved nor denied, the transfer will be automatically finalized after 5 days.

Transfer Notes

• A .hamburg domain transfer must be initiated with a so-called authorisation code, (auth-code) which can be obtained from the current registrar through the owner/admin contact of the domain.
• Ensure that your respective domain does not have a lock-status (clientTransferProhibited and/or serverTransferProhibited). This can be seen in WHOIS.
• If the domain has a client-side transfer lock, the owner can ask the current registrar to have the lock removed.

These procedures only apply for domain transfers between registrars. For internal transfers between resellers, please consult our documentation about internal transfers/usertransfers.

Auth-Codes

The format for auth info requires a minimum length of 8 characters and a maximum length of 32 characters.

Additionally, auth info must contain at least one of each of the following three character types:

• Alphabetic character:a-z;
• A-Z Numeric character : 0-9
• Special characters: !;<=$%?&@[()]*^+-,’-{.|/}:~

Domain Restore

(API Command reference » RestoreDomain)

Command

command = RestoreDomain
domain  = yourdomain.hamburg

Domain Extensions

X-HAMBURG-ACCEPT-TRUSTEE-TAC	0|1 The trustee offers a local contact in the city of Hamburg.

Domain Restrictions

Eligible to register a domain name under the top-level domain .hamburg is any natural person, legal person, organization or association of persons, if they can demonstrate that they have an economic, cultural, historical, social or any other connection to the metropolitan area of Hamburg, verifiable by:

• their residence or second home, office or place of business, a branch or permanent establishment in the metropolitan area of Hamburg, or
• a contact listed in the Whois (Owner/Admin-C) database with a domicile in the metropolitan area of Hamburg, or
• other appropriate proof e.g. the certification by an employer to enroll at a school or college, or birth certificate.

It is permissible for a proxy or a privacy service to register a domain name, acting for the actual owner of the domain name.

• Reserved domain names are sold by the registry themselves, wherefore it is only possible to register those domain names with an authcode acquired from the registry
  • A CheckDomain will provide the following response:
    [RESPONSE]
    code = 210
    description = Domain name available; Domain name not available publicly, RESERVATION

The .hamburg registry kindly reminds that all registrants who registered a .HAMBURG domain name need to comply with the registration requirements published on the registry website.