API Documentation

Everything you must know in one place

IMPORTANT: Our privacy service provider recently changed to WithheldforPrivacy. We want to avoid service interruption for our API users, so please note that in some cases, you may still see Whoisguard in the API parameter names.


You can only transfer .biz, .ca, .cc, .co, .com, .com.es, .com.pe, .es, .in, .info, .me, .mobi, .net, .net.pe, .nom.es, .org, .org.es, .org.pe, .pe, .tv, .us domains through API at this time.

NOTE: EPPcode with special characters must be converted into base64 format and sent in the format EPPcode=base64:converted code. Please refer to Example Request# 2 for clarification.

Example Requests


Request Parameters

Global parameters are not shown here for clarity, but should be present in all requests

Name Type MaxLength Required? Description
DomainName String 70 Yes Domain name to transfer
Years String 1 Yes Though it is possible to configure a transfer price up to 10 years, the duration should be set to 1 year only.
EPPCode String 20 Yes The EPPCode is required for transferring .biz, .ca, .cc, .co, .com, .com.pe, .in, .info, .me, .mobi, .net, net.pe, .org, .org.pe, .pe, .tv, .us domains only.
PromotionCode String 20 No Promotional (coupon) code for transfer
AddFreeWhoisguard String 3 No Adds free domain privacy for the domain
Default Value: Yes
WGenable String 3 No Enables free domain privacy for the domain
Default Value: No

Example Response

<?xml version="1.0" encoding="UTF-8"?>
<ApiResponse xmlns="http://api.namecheap.com/xml.response" Status="OK">
  <Errors />
  <CommandResponse Type="namecheap.domains.transfer.create">
    <DomainTransferCreateResult Domainname="domain.com" Transfer="true" TransferID="15" StatusID="-1" OrderID="575" TransactionID="759" ChargedAmount="8.88" StatusCode="2" />

Response Parameters

Name Description
DomainName The domain name that you are trying to transfer to Namecheap
Transfer Indicates whether the transfer order was placed successfully.
TransferID A unique integer value that represents the transfer
StatusID An integer value that indicates the current transfer status.
ChargedAmount The total amount charged for the transfer.
OrderID A unique integer value that represents the order
TransactionID A unique integer value that represents the transaction.
StatusCode Indicates the current transfer status.

Error Codes

Specifies the error codes that might be returned from this method

Number Description
2033409 Possibly a logical error in authentication phase. Order chargeable for Username is not found
2011170 Validation error from promotion code
2011280 TLD is not valid
2030280 TLD is not supported for API
2528166 Order creation failed
5050900 Unhandled exceptions


We welcome your comments, questions, corrections and additional information relating to this article. Your comments may take some time to appear. Please be aware that off-topic comments will be deleted.

If you need specific help with your account, feel free to contact our Support Team. Thank you.

Need help? We're always here for you.

× Close