API Documentation

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	This domain has either expired/ was transferred out/ is not associated with your account
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 domain privacy when AddWhoisguard is set as NO
2015267	EUAgreeDelete option should not be set as NO
2011170	Validation error from PromotionCode
2015182	The contact phone is invalid. The phone number format is +NNN.NNNNNNNNNN
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
2015182	The contact phone is invalid. The phone number format is +NNN.NNNNNNNNNN
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.getInfo

Number	Description
5019169	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.update

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
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.updateStatus

Number	Description
4019329	TransferStatus not available
2010293	No Action Specified
5050900	Unhandled exceptions

domains.transfer.getList

Number	Description
4019329	TransferStatus not available
2010293	No Action Specified
5050900	Unhandled exceptions

domains.transfer.getStatus

Number	Description
4019329	TransferStatus not available
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.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.getAddFundsStatus

Number	Description
2012342	TokenID mismatch
5050900	Unknown Exceptions

namecheap.users.createAddfundsRequest

Number	Description
2030343	Parameter PaymentType is unsupported
2019103	Username not found
2015312	Minimum amount should be added
2013312	Amount is out of range
2029341	Credit card not approved
5050900	Unknown Exceptions

namecheap.users.getBalances

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
2015182	The contact phone is invalid. The phone number format is +NNN.NNNNNNNNNN

namecheap.users.address.create

Number	Description
4011331	StatusCode for create is invalid
2015182	The contact phone is invalid. The phone number format is +NNN.NNNNNNNNNN
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 for getInfo is invalid
4022336	Failed to retrieve user's address

namecheap.users.address.getList

Number	Description
4011331	StatusCode for update is invalid

namecheap.users.address.update

Number	Description
4011331	StatusCode for update is invalid
4024336	Failed to update user's address
2015182	The contact phone is invalid. The phone number format is +NNN.NNNNNNNNNN

namecheap.users.address.setDefault

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

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
2015182	The contact phone is invalid. The phone number format is +NNN.NNNNNNNNNN
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.reissue

Number	Description
2010326	Error while validating administrative address
2011294 , 4011294	CertificateID is invalid
2019331	Certificate status is not available
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
2015182	The contact phone is invalid. The phone number format is +NNN.NNNNNNNNNN
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.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.parseCSR

Number	Description
2011300	CertificateType is invalid
3022296	Failed to retrieve CSR details from provider
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.ssl.purchasemoresans

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.revokecertificate

Number	Description
4011331	Status is invalid
2011300	Wrong SSL certificate selection. The type provided is not supported by command

namecheap.whoisguard.changeEmailAdrress

Number	Description
2011331	Domain privacy does not exists (or) domain privacy is not associated with any domain (or) domain privacy is not associated with this user

namecheap.whoisguard.enable

Number	Description
2011331	Domain privacy does not exists (or) domain privacy is not associated with any domain (or) domain privacy is not associated with this user
2011369	Error domain privacy forwarded Email address is not valid

namecheap.whoisguard.disable

Number	Description
2011331	Domain privacy does not exists (or) domain privacy is not associated with any domain (or) domain privacy is not associated with this user

namecheap.whoisguard.unallot

Number	Description
2011331	Domain privacy is not associated with any domain. So cannot unallot the domain privacy (or) domain privacy does not exists. So cannot unallot the domain privacy (or) domain privacy is not associated with this user. So cannot unallot the domain privacy

namecheap.whoisguard.discard

Number	Description
2011331	Domain privacy is not associated with this user, domain privacy is not discarded due to associated with domain

namecheap.whoisguard.allot

Number	Description
2011331	DOMAIN PRIVACY ALREADY EXISTS FOR THIS DOMAIN (or) THIS DOMAIN PRIVACY IS ALREADY ASSOCIATED WITH ANOTHER DOMAIN (or) domain privacy is not associated with this user (or) DOMAIN PRIVACY EXPIRED OR DOMAIN PRIVACY IS NOT IN USE
2011369	Domain privacy forwarded Email address is not valid
2011280	Domain privacy cannot be alloted/enabled for this domain