namecheap.domains.transfer.create
Transfers a domain to NameCheap. You can only transfer .com, .net, .org, .info, .biz, .us, .ca, .cc, .cn, .com.cn, .net.cn, .org.cn, .co.uk, .org.uk, .me.uk, .de , .co and .mobi domains at this time.
NOTE: EPP codes 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.
Request Parameters
Global parameters are not shown here for clarity, but should be present in all requests
| Name | Type | MaxLength | Required? | Default | Description |
| DomainName | String | 70 | Yes |
| Domain name to transfer |
| Years | String | 10 | Yes |
| Number of years to renew after a successful transfer |
| EPPCode | String | 20 | Yes | | The EPPCode is required for transferring .com, .net, .de, .org, .biz, .info, .mobi, .cn , .co, .ca and .us domains only. |
| PromotionCode | String | 20 | No
| | Promotional (coupon) code for transfer |
Example Request# 1
https://api.namecheap.com/xml.response?ApiUser=apiexample&ApiKey=56b4c87ef4fd49cb96d915c0db68194&
UserName=apiexample&Command=namecheap.domains.transfer.create&ClientIp=192.168.1.109&
DomainName=domain.com&Years=2&EPPCode=213456234554454453
Example Request# 2
https://api.namecheap.com/xml.response?ApiUser=apiexample&ApiKey=56b4c87ef4fd49cb96d915c0
db68194&UserName=apiexample&Command=namecheap.domains.transfer.create
&ClientIp=192.168.1.109&DomainName=domain.com&Years=1&
EPPCode=base64:cjY3OTBsJjg5ayQ2OD4=
Example Response
<?xml version="1.0" encoding="utf-8" ?>
<ApiResponse Status="OK" xmlns="http://api.namecheap.com/xml.response">
<Errors />
<RequestedCommand>namecheap.domains.transfer.create</RequestedCommand>
<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" />
</CommandResponse>
<Server>EV1SERVE-3CQ3CC</Server>
<GMTTimeDifference>+5</GMTTimeDifference>
<ExecutionTime>0.25</ExecutionTime>
</ApiResponse>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 |