RRPproxy Homepage
RRPproxy Homepage

.hamburg

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.

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 = (DOMAIN)
action = REQUEST
auth = (TEXT)

Transfer procedure

  • After the transfer has been requested, our backend system sends a confirmation email to the Owner/Admin-C according to the WHOIS of the respective domain. In order to initiate the transfer successfully it is important, that this email is confirmed.
  • After confirmation the transfer is initiated through the official registry and the losing registrar will receive the transfer request.
  • The losing registrar will also send an email to the Owner/Admin-C. allowing him/her to deny the transfer. If you do not respond to the email of the losing registrar, then the transfer will get processed successfully after 5 days.

If the Email-Address in the WHOIS is invalid, then the transfer cannot be processed.If this is the case, then kindly contact your current registrar and ask him to update the WHOIS information accordingly.

Transfer notes

  • A .hamburg domain transfer must be initiated with a so-called authorisation code, which can be obtained from the current registrar through the owner or Admin-C of the domain.
  • Ensure that your respective domain does not have a lock-status (REGISTRAR-LOCK or HOLD). This can be seen in the WHOIS.
  • If the domain is locked, then the owner can demand that the domain will be unlocked.
  • Please note that we are only allowed to initiate a gTLD transfer after confirmation of the "ICANN Form of Authorization" by the current registrant. The policies can be viewed under http://www.icann.org/transfers/
  • After a successful transfer of the domain, it will be transfer locked from the registry for a period of 60 days.

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

Wedomains :)