RRPproxy Homepage
RRPproxy Homepage


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)
command         = AddDomain
domain          = yourdomain.idv.tw
period          = (INT)
ownercontact0   = (CONTACT)
admincontact0   = (CONTACT)
techcontact0    = (CONTACT)
billingcontact0 = (CONTACT)
nameserver0	= (NAMESERVER)
nameserver1 	= (NAMESERVER)

X-TW-COMPANY-NUMBER only required if the owner is a company/organisation. For registrations with natural persons as owner, the extension is not mandatory.

Domain Modification

(API Command reference » ModifyDomain)
command = ModifyDomain
domain  = yourdomain.idv.tw

Domain Renewal

(API Command reference » RenewDomain)
command    = RenewDomain
domain     = yourdomain.idv.tw
period     = (INT)
expiration = (INT)

Domain Deletion

(API Command reference » DeleteDomain)
COMMAND = DeleteDomain
DOMAIN = yourdomain.idv.tw

Domain Transfer

(API Command reference » TransferDomain)
command = TransferDomain
domain = yourdomain.idv.tw
action = REQUEST
auth = (TEXT)

Transfer notes

  • .idv.tw domain transfer must be initiated with a valid "Authorization Code" that can be obtained from the current registrar through the owner or Admin-C of the domain.
  • Ensure that the respective domain does not have a lock-status (REGISTRAR-LOCK or HOLD).
  • Initiate the transfer on time and not just shortly before the domain expires. The domain must be older than 60 days or the last transfer must be more than 60 days ago, otherwise the transfer will be denied.
  • The transfer request is processed following a FOA handling: A notification e-mail will be sent to the registrant who must confirm the requested transfer. The transfer will only be processed after confirmation. Otherwise the transfer request expires.

Domain Restore

(API Command reference » RestoreDomain)
command = RestoreDomain
domain  = yourdomain.idv.tw

Domain Extensions

X-TW-COMPANY-NUMBERVAT number required, if the owner is a company/organisation

Domain Restrictions

Registrants of .idv.tw domains must comply to the General Terms and Conditions of .tw domains:

  • Supervision and Guidance Regulation for Internet Protocol (IP) Address and Domain Name Registration and Management Services currently at http://www.twnic.net.tw/file/ip0320.htm
  • Guidelines for Administration of Domain Name Registration, currently at https://www.twnic.net.tw/en_dnservice_giuldlines.php
  • Domain Name Registration Policies and Regulations, currently at https://www.twnic.net.tw/en_dnservice_guidelines_regulation.php
  • TWNIC Domain Name Dispute Resolution Policy, currently at https://www.twnic.net.tw/en_dnservice_policy-1.php
  • Rules for TWNIC Domain Name Dispute Resolution Policy, currently at https://www.twnic.net.tw/en_dnservice_policy-2.php
  • A registration for .ORG.TW domains is now only possible for non profit organizations located in Taiwan. The only exception is for foreign non-profit organizations that provide supporting documentation of their non-profit status under the competent laws of their jurisdiction and if the Domain Name Committee of TWNIC approves such documentation. You can download the necessary document for an application of a .ORG.TW domain name here: Application_for_ORG.TW.pdf
  • The registrant for a .COM.TW domain name must be a corporation registered under the Company Law or a business registered under the Commercial Entity Registration Law, or a foreign corporation registered under competent national or state laws. Also the registrant should provide true, complete and accurate information. The registrant will be asked to submit documentations for review when necessary.

IDN Information

  • Traditional Chinese characters only beneath .TW and not for Third-Level .TW domains.

Supported IDN Scripts

The following IDN scripts are supported by .idv.tw.
Provide the LANGUAGE TAG corresponding to your desired IDN within the AddDomain command as X-IDN-LANGUAGE extension.


Get more information of "IDN tables", which represent permitted code points (letters) allowed for Internationalised Domain Name registrations in particular registries on IANA Repository of IDN Practices.

Wedomains :)