.music

API commandsExtensionsRestrictions

Important

There are Reserved Domains available for this TLD. These domains are shown as ‘available’ in CNR, but they can be registered only with under specific conditions of the registry, which need to be addressed offline. Once a Reserved Domain is allocated to a customer, then this domain can be registered and managed in CNR (e.g. based on a token provided by the registry).

Important

Starting with 2026-04-01, registrations for .music domains are realtime. Newly registered .music domains will no longer be placed on immediate serverHold, domains will be active immediately upon successful registration. Identity verification at id.music is still required, but registrants will have up to one year to complete it.

Per registry requirement, resellers are asked to provide upfront a notice of this process, to potential registrars, and to store their agreement up to 90 days. Here is the suggested English version of the notice, with “Yes”/”No” options that should follow:

“I fully understand and agree that the Registry has the right to audit this attestation declaration and an audit failure can lead to immediate suspension or revocation, without refund, of any or all .MUSIC domains connected to the registrant.”

CNR offers a domain extension X-MUSIC-ACCEPT-TAC=0|1, to mark and store the registrants acceptance of notice. The extension is not enforced for now.

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.music
period          = (INT)
ownercontact0   = (CONTACT)
admincontact0   = (CONTACT)
techcontact0    = (CONTACT)
billingcontact0 = (CONTACT)
nameserver0  = (NAMESERVER)
nameserver1   = (NAMESERVER)
X-MUSIC-ACCEPT-TAC = 0|1

• Registrants will receive an email from the registry where they will be asked to access the dedicated page id.music for identity verification. Domains will be active immediately and registrants will have up to one year to verify their identity.

Domain Modification

(API Command reference » ModifyDomain)

Command

command = ModifyDomain
domain  = yourdomain.music

Change of Registrant

Exception

command         = ModifyDomain
domain          = yourdomain.music
ownercontact0   = (CONTACT)
X-MUSIC-ACCEPT-TAC = 0|1

• New domain holders will receive an email from the registry where they will be asked to access the dedicated page id.music in order to complete their verification. The registry may suspend or revoke the domain if this is not done.

Domain Renewal

(API Command reference » RenewDomain)

Command

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

Domain Deletion

(API Command reference » DeleteDomain)

Command

COMMAND = DeleteDomain
DOMAIN = yourdomain.music

Domain Transfer

(API Command reference » TransferDomain)

Command

command = TransferDomain
domain = yourdomain.music
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 .music 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 characters: a-z; A-Z
• Numeric characters: 0-9
• Special characters: !;<=$%?&@[()]*^+-,’-{.|/}:~

Domain Restore

(API Command reference » RestoreDomain)

Command

command = RestoreDomain
domain  = yourdomain.music

Domain Extensions

X-MUSIC-ACCEPT-TAC	0|1 -> Registrant’s acceptance of notice that an audit failure to his identity or connection to music industry can lead to the registration to be revoked without refund

Domain Restrictions

There are no restrictions for .music