Authentication Error Codes (common for all commands)

Number Description
1010101 Parameter APIUser is missing
1030408 Unsupported authentication type
1010104 Parameter Command is missing
1010102, 1011102 Parameter APIKey is missing
1010105, 1011105 Parameter ClientIP is missing
1050900 Unknown error when validating APIuser
1011150 Parameter RequestIP is invalid
1017150 Parameter RequestIP is disabled or locked
1017105 Parameter ClientIP is disabled or locked
1017101 Parameter ApiUser is disabled or locked
1017410 Too many declined payments
1017411 Too many login attempts
1019103 Parameter UserName is not available
1016103 Parameter UserName is unauthorized
1017103 Parameter UserName is disabled or locked

namecheap.domains.getList

Number Description
5019169 Unknown exceptions while retriving Domain list

namecheap.domains.getContacts

Number Description
2019166 Domain not found
2016166 Domain is not associate with your account
4019337 Unable to retrieve domain contacts
3016166 Domain is not associate with Enom
3019510 Error response from provider
3050900 Unknown response from provider
5050900 Unknown exceptions

namecheap.domains.create

Number Description
2033409 Possibly a logical error in authentication phase. The order chargeable for Username is not found
2033407, 2033270 Cannot enable Whoisguard when AddWhoisguard is set as NO
2015267 EUAgreeDelete option should not be set as NO
2011170 Validation error from PromotionCode
2011280 Validation error from TLD
2015167 Validation error from Years
2030280 TLD is not supported in API
2011168 Nameservers are not valid
2011322 Extended Attributes are not Valid 
2010323 Check required field for billing domain contacts
2528166 Order creation failed
3019166,4019166 Domain not available
3031166 Error while getting information from provider
3028166 Error from Enom ( Errcount <> 0 )
3031900 Unknown Response from provider
4023271 Error while adding free positive ssl for the domain
3031166 Error while getting Domin status from Enom
4023166 Error while adding domain
5050900 Unknown error while adding domain to your account
4026312 Error in refunding funds
5026900 Unknown exceptions error while refunding funds

namecheap.domains.getTldList

Number Description
2011166 UserName is invalid
3050900 Unknown response from provider

namecheap.domains.setContacts

Number Description
2019166 Domain not found
2030166 Edit permission for domain is not supported
2010324 Registrant contacts such as firstname, lastname etc are missing
2010325 Tech contacts such as firstname, lastname etc are missing
2010326 Admin contacts such as firstname, lastname etc are missing
2010327 AuxBilling contacts such as firstname, lastname etc are missing
2016166 Domain is not associated with your account
2011280 Cannot see the contact information for your TLD
4022323 Error from retrieving domain Contacts
2011323 Error retrieving domain Contacts from Enom (Invalid errors)
3031510 Error From Enom when error count <>0
3050900 Unknown error from Enom

namecheap.domains.check

Number Description
3031510 Error response from Enom when the error count != 0
3011511 UnKnown response from Provider

namecheap.domains.reactivate

Number Description
 2033409 Possibly a logical error in authentication phase. Order chargeable for Username is not found
 2019166 Domain not found
 2030166 Edit permission for Domain is not supported
 2011170 Promotion Code is invalid
 2011280 TLD is invalid
2528166 Order creation failed
3024510 Error Response from Enom while updating domain
3050511 Unknown error response from Enom
2020166 Domain does not meet the expire date
2016166 Domain is not associate with your account
5050900 Unhandled exceptions
4024166 Failed to update domain in your account

namecheap.domains.renew

Number Description
2033409 Possibly a logical error in authentication phase. Order chargeable for Username is not found
2011170 Promotion Code is invalid
2011280 TLD is invalid
2528166 Order creation failed
2020166 Domain has expired.Please reactivate your domain
3028166 Failed to renew error from Enom
3031510 Error From Enom when Errorcount <> 0
3050900 Unknown error from Enom
2016166 Domain is not associated with your account
4024167 Failed to update years for your domain
4023166 Error occured while domain renewal
4022337 Error in refunding funds

namecheap.domains.getRegistrarLock

Number Description
2019166 Domain not found
2016166 Domain is not associate with your account
3031510 Error response from provider when errorcount !=0
3050900 Unknown error response from Enom
5050900 Unknown exceptions

namecheap.domains.setRegistrarLock

Number Description
2015278 Invalid data specified for LockAction
2019166 Domain not found
2016166 Domain is not associate with your account
3031510 Error From Enom when Errorcount <> 0
2030166 Edit permission for Domain is not supported
3050900 Unknown error response from Enom
5050900 Unknown exceptions

namecheap.domains.dns.setDefault

Number Description
2019166 Domain not found
2016166 Domain is not associated with your account
2030166 Edit permission for domain is not supported
3013288 Too many records
3031510 Error From Enom when Errorcount <> 0
3050900 Unknown error from Enom
4022288 Unable to get nameserver list 

namecheap.domains.dns.setCustom

Number Description
2019166 Domain not found
2016166 Domain is not associated with your account
2030166 Edit permission for domain is not supported
3031510 Error From Enom when Errorcount <> 0
3050900 Unknown error from Enom
4022288 Unable to get nameserver list 

namecheap.domains.dns.getList

Number Description
2019166 Domain not found
2016166 Domain is not associated with your account
3031510 Error From Enom when Errorcount <> 0
3050900 Unknown error from Enom
4022288 Unable to get nameserver list 

namecheap.domains.dns.getHosts

Number Description
2019166 Domain not found
2030166 Edit Permission for Domainname is not supported
4023330 Unable to get DNS hosts from list
3031510 Error From Enom when Errorcount <> 0
2030288 Cannot complete this command as this domain is not using proper DNS servers
3050900 Unknown error from Enom
3011288 Invalid nameserver specified
5050900 Unhandled Exceptions

namecheap.domains.dns.setHosts

Number Description
2019166 Domain not found
2016166 Domain is not associated with your account
2030166 Edit Permission for domain is not supported
3013288, 4013288 Too many records
3031510 Error From Enom when Errorcount <> 0
3050900 Unknown error from Enom
4022288 Unable to get nameserver list

namecheap.domains.dns.getEmailForwarding

Number Description
2019166 Domain not found
2030166 Edit Permission for domain is not supported
3031510 Error From Enom when Errorcount <> 0
3050900 Unknown error from Enom
2030288 Cannot complete this command as this domain is not using proper DNS servers
4022328 Unable to get EmailForwarding records from database
3011288 Invalid nameserver
5050900 Unhandled exceptions

namecheap.domains.dns.setEmailForwarding

Number Description
 2019166 Domain not found
2016166 Domain is not associated with your account
2030166 Edit Permission for domain is not supported
3013288 Too many records
3031510 Error From Enom when Errorcount <> 0
3050900 Unknown error from Enom
2030288 Cannot complete this command as this domain is not using proper DNS servers
4022288 Unable to get nameserver list

domains.ns.create

Number Description
2019166 Domain not found
2016166 Domain is not associated with your account
3031510 Error From Enom when Errorcount <> 0
3050900 Unknown error from Enom

domains.ns.delete

Number Description
2019166 Domain not found
2016166 Domain is not associated with your account
3031510 Error From Enom when Errorcount <> 0
3050900 Unknown error from Enom

domains.ns.getInfo

Number Description
2019166 Domain not found
2016166 Domain is not associated with your account
2030166 Edit permission for domain is not supported
3031510 Error From Enom when Errorcount <> 0
3050900 Unknown error from Enom

domains.transfer.create

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

domains.transfer.getStatus

Number Description
4019329 TransferStatus not available
 5050900 Unhandled exceptions

namecheap.ssl.activate

Number Description
2010326 Error while validating administrative address
2011294 , 4011294 CertificateID is invalid
2019331 Certificate status is not available
4020294 Activation period for this certificate is over
4011331
Certificate status is invalid
4011297 , 2011297
WebServerType is invalid
3011166
Invalid renewal order domain
3011296
The CSR provided is invalid
4024295
Unable to update ApproverEmail in database
4024331
Unable to update status in database
3028301
Failed to purchase certificate
3011295
ApproverEmail is not valid
3022295
Failed to retrieve ApproverEmail from provider
2011300
Validation for True Business with EV
2030332
Config file value does not support for activation
2010297
WebServerType is missing
4011296
CSR invalid error from Provider
4024294
Failed to update CertificateID
4027295
Failed to send ApproverEmail
2011510
Partner name is invalid
5050900
Unhandled exceptions
2011333
xmlfile is missing error while getting xml form from filepath and xmlstring from config file
4050900
Unhandled exception from database error

namecheap.ssl.create

Number Description
2033409 Possibly a logical error in authentication phase. Order chargeable for Username is not found
2015167 Number of years should be maximum 10
2011301 SSLType is invalid
2011170 Promotion code is invalid
4011299
The Purchasevalidationid already exists.The certificate cannot be created
2528166 Order creation failed
5050900
Unhandled exceptions

namecheap.ssl.getApproverEmailList

Number Description
2011296 CSR is invalid
2011300 , 4011300 CertificateType is invalid
2011166 DomainName is invalid
3022295 Failed to retrieve ApproverEmail
5050900 Unhandled exceptions

namecheap.ssl.getInfo

Number Description
2011294 CertificateID is invalid
 5050900 Unhandled exceptions

namecheap.ssl.getList

Number Description
2011272 ListType is invalid
 5050900 Unhandled exceptions

namecheap.ssl.renew

Number Description
2033409 Possibly a logical error in authentication phase. Order chargeable for Username is not found
2015167 Number of years should be maximum 10
2011301 SSLType is invalid
2011170 Promotion code is invalid
4011294
CertificateID is invalid
2528166 Order creation failed
5050900
Unhandled exceptions

namecheap.ssl.resendApproverEmail

Number Description
2011294 CertificateID is invalid
2011331 Status is invalid
3011295 ApproverEmail is invalid
5050900 Unhandled exceptions

namecheap.ssl.resendFullfillmentEmail

Number Description
2011294 CertificateID is invalid
2011331 Status is invalid
3022334
 Failed to resend fulfillment email
 5050900 Unhandled exceptions

namecheap.users.changePassword

Number Description
2015103 Cannot change UserName and ResetCode at a time
2010302
OldPassword is missing
2010103 UserName is missing
2010303 ResetCode is missing
4011331
Invalid status
4022335
Unable to change password
5050900
Unhandled exceptions

namecheap.users.create

Number Description
2011153 Email address is invalid
2011163 Phone is invalid
2011165 Fax is invalid
2011151 First Name is invalid
2011152
LastName is invalid
2011103 UserName is invalid
2033153
Email address is already in use
4011331
StatusCode for create user is invalid
4022103
Failed to create user

namecheap.users.login

Number Description
2011335 Parameter Password is missing
2019166 UserName is not available
2010335 Invalid password
2017166 User is disabled or locked
2013410
Too many declined payments
2017289
Parameter IP Blocked
2011166 UserName is invalid
5050900 Unhandled exceptions

namecheap.users.getBalance

Number Description
4022312 Balance information is not available

namecheap.users.getPricing

Number Description
2011170 PromotionCode is invalid
2011298
ProductType is invalid

namecheap.users.resetPassword

Number Description
2011315 FindBy is invalid
4027153
Failed to send email
4022335
Unable to reset password
5050900
Unhandled exceptions

namecheap.users.update

Number Description
4011331 StatusCode for update is invalid
4024103
Failed to update user

namecheap.users.address.create

Number Description
4011331 StatusCode for create is invalid
4023336
Failed to add user's address

namecheap.users.address.delete

Number Description
4011331 StatusCode for delete is invalid
4023336
Failed to delete user's address

namecheap.users.address.getInfo

Number Description
4011331 StatusCode to getInfo is invalid
4023336
Failed to get user's address

namecheap.users.address.update

Number Description
4011331 StatusCode for update is invalid
4023336
Failed to update user's address

namecheap.users.address.setDefault

Number Description
4023336
Failed to get set default user's address

Comments

Support requests, bug reports, and off-topic comments will be deleted without warning.

Please do post corrections or additional information/ pointers for this article below. We aim to quickly move corrections into the documentation. Also, your comments may take some time to appear.

If you need specific help with your account, please contact Support

We are an ICANN accredited registrar. Serving customers since 2001
TRUSTe online privacy certification
Verisign Security Seal - Click to Verify
Payment Options
Supported Currency Conversions