.my

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)

Command

command         = AddDomain
domain          = yourdomain.my
period          = (INT)
ownercontact0   = (CONTACT)
admincontact0   = (CONTACT)
techcontact0    = (CONTACT)
billingcontact0 = (CONTACT)
nameserver0  = (NAMESERVER)
nameserver1   = (NAMESERVER)
X-MY-OWNER-DATEOFBIRTH = (YYYY-MM-DD)
X-MY-OWNER-IDENTIFICATIONNUMBER = (TEXT)
X-MY-ADMIN-ORGANIZATION-TYPE = (OTA code)
X-MY-ADMIN-ORGANIZATION-REGISTRATION-NUMBER = (TEXT)
X-MY-TECH-DATEOFBIRTH = (YYYY-MM-DD)
X-MY-TECH-IDENTIFICATIONNUMBER = (TEXT)
X-MY-BILLING-ORGANIZATION-TYPE = (OTA code)
X-MY-BILLING-ORGANIZATION-REGISTRATION-NUMBER = (TEXT)

• X-MY extensions are needed for each contact type (OWNER, ADMIN, TECH and BILLING) and only 2 of them are needed per contact, depending on whether the contact is an individual or an organization:
  • For Individuals, the extensions needed are X-MY-{TYPE}-DATEOFBIRTH and X-MY-{TYPE}-IDENTIFICATIONNUMBER (IC / Passport number).
  • For Organizations, the extensions needed are X-MY-{TYPE}-ORGANIZATION-TYPE and X-MY-{TYPE}-ORGANIZATION-REGISTRATION-NUMBER.{TYPE} = OWNER | ADMIN | BILLING | TECH
• Valid Organization Type (OTA) codes:
  • OTA000005 = Business
  • OTA000003 = Company
  • OTA000025 = Non Profit Organization
  • OTA000006 = Education
  • OTA000012 = Legal Professional
  • OTA000032 = Others

Domain Modification

(API Command reference » ModifyDomain)

Standard command

command = ModifyDomain
domain  = yourdomain.my

Change of Registrant

Exception

command          = ModifyDomain
domain           = yourdomain.my
addownercontact0 = (CONTACT)
delownercontact0 = (CONTACT)
X-MY-OWNER-DATEOFBIRTH = (YYYY-MM-DD)
X-MY-OWNER-IDENTIFICATIONNUMBER = (TEXT)
or
X-MY-OWNER-ORGANIZATION-TYPE = (OTA code)
X-MY-OWNER-ORGANIZATION-REGISTRATION-NUMBER = (TEXT)

Change of registrant is now a direct contact-data update via ModifyDomain (no TradeDomain, no ICANN FOA, no additional cost). Please use the 2 extensions corresponding to the new owner contact’s type: Individual (DATEOFBIRTH / IDENTIFICATIONNUMBER) or Organization (ORGANIZATION-TYPE / ORGANIZATION-REGISTRATION-NUMBER).

Domain Renewal

(API Command reference » RenewDomain)

Command

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

Domain Deletion

(API Command reference » DeleteDomain)

Command

COMMAND = DeleteDomain
DOMAIN = yourdomain.my

Domain Transfer

(API Command reference » TransferDomain)

Exception

command       = TransferDomain
domain        = yourdomain.my
action        = REQUEST
auth          = (TEXT)
ownercontact0 = (CONTACT, required)
admincontact0 = (CONTACT, required)
techcontact0  = (CONTACT, required)

X-MY contact extensions are required per contact (Individual or Organization, see AddDomain above).

Approve or Deny an Incoming Transfer-away

Exception

command = TransferDomain
domain  = yourdomain.my
action  = APPROVE|DENY

Domain Restore

(API Command reference » RestoreDomain)

Command

command = RestoreDomain
domain  = yourdomain.my

After a 40 days renew grace period (RenewDomain is still accepted), there will be a 30 days redemption period where the RestoreDomain command is needed. After day 70 the domain is purged and unrecoverable.

Domain Extensions for Natural Persons

X-MY-{TYPE}-DATEOFBIRTH	(YYYY-MM-DD) Date of birth
X-MY-{TYPE}-IDENTIFICATIONNUMBER	(TEXT) ID / Passport number

Domain Extensions for Organisations or Companies

X-MY-{TYPE}-ORGANIZATION-TYPE	(OTA code) Valid Organization Type codes: OTA000005 = Business OTA000003 = Company OTA000025 = Non Profit Organization OTA000006 = Education OTA000012 = Legal Professional OTA000032 = Others
X-MY-{TYPE}-ORGANIZATION-REGISTRATION-NUMBER	(TEXT)

{TYPE} = OWNER | ADMIN | BILLING | TECH

Domain Restrictions

There are no restrictions for .my