Unsuccessful responses

Errors

Error responses contain an errorCode and errorMessage that describe why the request failed. The response is formatted in x-www-form-urlencoded format.

Example error response

errorCode=-3&errorMessage=The+%27logoPriorUseDomainName%27+argument+is+missing%21

Response parameters

Parameter Type Description

Parameter	Type	Description
`errorCode`	integer	A numeric code that identifies the type of the error. For more details, see Error codes.
`errorMessage`	string	A description of the error.
`errorDetail`	string	Additional details about the error, when available.

errorCode

integer

A numeric code that identifies the type of the error. For more details, see Error codes.

errorMessage

string

A description of the error.

errorDetail

string

Additional details about the error, when available.

Error codes

Error Code Detail Description

Error Code	Detail	Description
AutoApplyOrder
-1	Request was not made over https!	The request must use HTTPS protocol.
-3	The `xxxx` argument is missing!	A required argument is missing from the request.
-4	The value of the `xxxx` argument is invalid!	The argument value does not meet validation requirements.
-7	`xx` is not a valid ISO-3166 country!	The specified country code is not valid according to the ISO-3166 standard.
-15	Not enough credit!	The account does not have sufficient credit.
-16	Incorrect login details, account is locked, password has expired or your source IP is blocked.	The authentication failed due to incorrect login details, a locked account, an expired password, or a blocked source IP address.
-17	Request used `GET` rather than `POST`!	The request method should be `POST`.
-91	Permission denied `Context`	The user does not have permission for the requested context.
-115	No price found! Contact Support!	No price information available for the specified item.
-160	General error	The `errorMessage` contains a message from SSL.com.
-162	The CSR must not contain domain names that are not in the `domainNames` parameter!	The CSR contains domain names not listed in the `domainNames` parameter.
autoRevokeCertificate
-1	Request was not made over https!	The request must use HTTPS protocol.
-2	Unrecognised argument!	The provided argument is not recognized.
-3	The `xxxx` argument is missing!	A required argument is missing from the request.
-4	The value of the `xxxx` argument is invalid!	The argument value does not meet validation requirements.
-14	An unknown error occurred!	An unknown error occurred.
-16	Incorrect login details, account is locked, password has expired or your source IP is blocked.	Authentication failed due to incorrect login, locked account, expired password, or blocked IP.
-17	Request used GET rather than POST!	The request method should be `POST`.
-20	The certificate request has already been rejected!	The certificate request cannot be processed because it has been rejected.
-21	The certificate has already been revoked!	The certificate has already been revoked.
-35	The Certificate does not allow revocation after expiry!	The certificate cannot be revoked because it is expired.
-42	Call limit reached! Please try again later	The maximum number of allowed API requests has been exceeded. Please wait before submitting additional requests.
-43	Certificate is not in a revocable state	The certificate cannot be revoked in its current state.
-160	Failed to revoke certificate.	The certificate revocation failed due to a general error.
CollectMC
-1	Request was not made over https!	The request must use HTTPS protocol.
-2	Unrecognised argument!	The provided argument is not recognized.
-3	The `xxxx` argument is missing!	A required argument is missing from the request.
-4	The value of the `xxxx` argument is invalid!	The argument value does not meet validation requirements.
-14	An unknown error occurred!	An unspecified error occurred during the request.
-16	Incorrect login details, account is locked, password has expired or your source IP is blocked.	Authentication failed due to incorrect login details, a locked account, an expired password, or a blocked source IP address.
-17	Request used GET rather than POST!	The request method should be `POST`.
-20	The certificate request has been rejected!	The certificate request cannot be processed because it has been rejected.
-21	The certificate has been revoked!	The certificate cannot be collected because it has been revoked.
-22	Still awaiting payment!	The certificate cannot be collected because payment is still pending.
-91	Permission denied! `xxxx`	The user does not have permission for the specified context.
-160	Failed to collect the certificate.	The certificate collection failed due to a general error.
AutoReplaceMC
-1	Request was not made over https!	The request must use HTTPS protocol.
-2	Unrecognised argument!	The provided argument is not recognized.
-3	The `xxxx` argument is missing!	A required argument is missing from the request.
-4	The value of the `xxxx` argument is invalid!	The argument value does not meet validation requirements.
-7	`xx` is not a valid ISO-3166 country!	The specified country code is not valid according to the ISO-3166 standard.
-14	An unknown error occurred!	An unknown error occurred.
-15	Not enough credit!	The account does not have sufficient credit.
-16	Incorrect login details, account is locked, password has expired or your source IP is blocked.	Authentication failed due to incorrect login details, a locked account, an expired password, or a blocked source IP address.
-17	Request used GET rather than POST!	The request method should be `POST`.
-36	The certificate has already expired!	The certificate cannot be replaced because it has expired.
-91	Permission denied `xxxx`	The user does not have permission for the specified context.
-110	CSR decoding Internal Error	An internal error occurred while decoding the CSR.
-115	No price found for `xxxx`	No price information available for the specified item.
-160	Failed to replace order #`xxxx`.	The order replacement failed due to a general error.
-161	Parameter `xxxx` is not applicable to this type of product!	The specified parameter is not valid for this product type.
-162	The CSR must not contain domain names that are not in the `domainNames` parameter!	The CSR contains domain names not listed in the `domainNames` parameter.
-163	The CSR must not contain domain names that are not in the list of certificate domain names!	The CSR contains domain names not listed in the certificate’s domain names.
AutoUpdateDCV
-1	Request was not made over https!	The request must use HTTPS protocol.
-2	`xxxx` is an unrecognised argument!	The provided argument is not recognized.
-3	The `xxxx` argument is missing!	A required argument is missing from the request.
-4	The value of the `xxxx` argument is invalid!	The argument value does not meet validation requirements.
-14	An unknown error occurred!	An unspecified error occurred during the request.
-16	Incorrect login details, account is locked, password has expired or your source IP is blocked.	Authentication failed due to incorrect login details, a locked account, an expired password, or a blocked source IP address.
-17	Request used GET rather than POST!	The request method should be `POST`.
-47	`domainName` is already validated!	The specified domain name has already been validated.
-139	Unexpected certificate state!	The certificate is in an unexpected state.
-160	The attempt to update the DCV method(s) did not succeed.	The DCV method update failed due to a general error.
ResendDCVEmail
-1	Request was not made over https!	The request must use HTTPS protocol.
-2	`xxxx` is an unrecognised argument!	The provided argument is not recognized.
-3	The `xxxx` argument is missing!	A required argument is missing from the request.
-4	The value of the `xxxx` argument is invalid!	The argument value does not meet validation requirements.
-14	An unknown error occurred!	An unspecified error occurred during the request.
-16	Incorrect login details, account is locked, password has expired or your source IP is blocked.	Authentication failed due to incorrect login details, a locked account, an expired password, or a blocked source IP address.
-17	Request used GET rather than POST!	The request method should be `POST`.
GetDCVEmailAddressList
-1	Request was not made over https!	The request must use HTTPS protocol.
-2	Unrecognised argument!	The provided argument is not recognized.
-3	The `xxxx` argument is missing!	A required argument is missing from the request.
-4	The value of the `xxxx` argument is invalid!	The argument value does not meet validation requirements.
-14	An unknown error occurred!	An unspecified error occurred during the request.
-16	Incorrect login details, account is locked, password has expired or your source IP is blocked.	Authentication failed due to incorrect login details, a locked account, an expired password, or a blocked source IP address.
-17	Request used GET rather than POST!	The request method should be `POST`.
-19	The Domain Name may not be an Internet-accessible IP Address!	Domain names must not be Internet-accessible IP addresses.
-37	The Domain Name is an Intranet Server Name or Intranet IP Address!	Domain names must not be intranet server names or intranet IP addresses.
-91	Permission Denied. Not allowed to use the AUTO-Apply service.	The user is not permitted to use the AUTO-Apply service.
GetDetailedOrderStatus
-1	Request was not made over https!	The request must use HTTPS protocol.
-2	`xxxx` is an unrecognised argument!	The provided argument is not recognized.
-3	The `xxxx` argument is missing	A required argument is missing from the request.
-4	The value of the `xxxx` argument is invalid!	The argument value does not meet validation requirements.
-14	An unknown error occurred!	An unspecified error occurred during the request.
-16	Permission denied!	Authentication failed due to permission issues.
-17	Request used GET rather than POST!	The request method should be `POST`.
getPostPaymentStatus
-1	Request was not made over https!	The request must use HTTPS protocol.
-2	`<errorItem>` is an unrecognised argument!	The provided argument is not recognized.
-3	The `<errorItem>` argument is missing!	A required argument is missing from the request.
-4	The value of the `<errorItem>` argument is invalid!	The argument value does not meet validation requirements.
-14	An unknown error occurred!	An unspecified error occurred during the request.
-16	Incorrect login details, account is locked, password has expired or your source IP is blocked.	Authentication failed due to incorrect login details, a locked account, an expired password, or a blocked source IP address.
-17	Request used GET rather than POST!	The request method should be `POST`.
-42	Call limit reached! Please try again later	The maximum number of allowed API requests has been exceeded. Please wait before submitting additional requests.
-43	Certificate is not in a revocable state	The certificate cannot be revoked in its current state.
-160	Failed to revoke certificate.	The certificate revocation failed due to a general error.
initCustomerSession
-1	Request was not made over https!	The request must use HTTPS protocol.
-2	`xxxx` is an unrecognised argument!	The provided argument is not recognized.
-3	The `xxxx` argument is missing!	A required argument is missing from the request.
-4	The value of the `xxxx` argument is invalid!	The argument value does not meet validation requirements.
-14	An unknown error occurred!	An unspecified error occurred during the request.
-16	Incorrect login details, account is locked, password has expired or your source IP is blocked.	Authentication failed due to incorrect login details, a locked account, an expired password, or a blocked source IP address.
-17	Request used GET rather than POST!	The request method should be `POST`.
-42	Call limit reached! Please try again later	The maximum number of allowed API requests has been exceeded. Please wait before submitting additional requests.
-43	Certificate is not in a revocable state	The certificate cannot be revoked in its current state.
-160	Failed to revoke certificate.	The certificate revocation failed due to a general error.

AutoApplyOrder

-1

Request was not made over https!

The request must use HTTPS protocol.

-3

The xxxx argument is missing!

A required argument is missing from the request.

-4

The value of the xxxx argument is invalid!

The argument value does not meet validation requirements.

-7

xx is not a valid ISO-3166 country!

The specified country code is not valid according to the ISO-3166 standard.

-15

Not enough credit!

The account does not have sufficient credit.

-16

Incorrect login details, account is locked, password has expired or your source IP is blocked.

The authentication failed due to incorrect login details, a locked account, an expired password, or a blocked source IP address.

-17

Request used GET rather than POST!

The request method should be POST.

-91

Permission denied Context

The user does not have permission for the requested context.

-115

No price found! Contact Support!

No price information available for the specified item.

-160

General error

The errorMessage contains a message from SSL.com.

-162

The CSR must not contain domain names that are not in the domainNames parameter!

The CSR contains domain names not listed in the domainNames parameter.

autoRevokeCertificate

-1

Request was not made over https!

The request must use HTTPS protocol.

-2

Unrecognised argument!

The provided argument is not recognized.

-3

The xxxx argument is missing!

A required argument is missing from the request.

-4

The value of the xxxx argument is invalid!

The argument value does not meet validation requirements.

-14

An unknown error occurred!

An unknown error occurred.

-16

Incorrect login details, account is locked, password has expired or your source IP is blocked.

Authentication failed due to incorrect login, locked account, expired password, or blocked IP.

-17

Request used GET rather than POST!

The request method should be POST.

-20

The certificate request has already been rejected!

The certificate request cannot be processed because it has been rejected.

-21

The certificate has already been revoked!

The certificate has already been revoked.

-35

The Certificate does not allow revocation after expiry!

The certificate cannot be revoked because it is expired.

-42

Call limit reached! Please try again later

The maximum number of allowed API requests has been exceeded. Please wait before submitting additional requests.

-43

Certificate is not in a revocable state

The certificate cannot be revoked in its current state.

-160

Failed to revoke certificate.

The certificate revocation failed due to a general error.

CollectMC

-1

Request was not made over https!

The request must use HTTPS protocol.

-2

Unrecognised argument!

The provided argument is not recognized.

-3

The xxxx argument is missing!

A required argument is missing from the request.

-4

The value of the xxxx argument is invalid!

The argument value does not meet validation requirements.

-14

An unknown error occurred!

An unspecified error occurred during the request.

-16

Incorrect login details, account is locked, password has expired or your source IP is blocked.

Authentication failed due to incorrect login details, a locked account, an expired password, or a blocked source IP address.

-17

Request used GET rather than POST!

The request method should be POST.

-20

The certificate request has been rejected!

The certificate request cannot be processed because it has been rejected.

-21

The certificate has been revoked!

The certificate cannot be collected because it has been revoked.

-22

Still awaiting payment!

The certificate cannot be collected because payment is still pending.

-91

Permission denied! xxxx

The user does not have permission for the specified context.

-160

Failed to collect the certificate.

The certificate collection failed due to a general error.

AutoReplaceMC

-1

Request was not made over https!

The request must use HTTPS protocol.

-2

Unrecognised argument!

The provided argument is not recognized.

-3

The xxxx argument is missing!

A required argument is missing from the request.

-4

The value of the xxxx argument is invalid!

The argument value does not meet validation requirements.

-7

xx is not a valid ISO-3166 country!

The specified country code is not valid according to the ISO-3166 standard.

-14

An unknown error occurred!

An unknown error occurred.

-15

Not enough credit!

The account does not have sufficient credit.

-16

Incorrect login details, account is locked, password has expired or your source IP is blocked.

Authentication failed due to incorrect login details, a locked account, an expired password, or a blocked source IP address.

-17

Request used GET rather than POST!

The request method should be POST.

-36

The certificate has already expired!

The certificate cannot be replaced because it has expired.

-91

Permission denied xxxx

The user does not have permission for the specified context.

-110

CSR decoding Internal Error

An internal error occurred while decoding the CSR.

-115

No price found for xxxx

No price information available for the specified item.

-160

Failed to replace order #xxxx.

The order replacement failed due to a general error.

-161

Parameter xxxx is not applicable to this type of product!

The specified parameter is not valid for this product type.

-162

The CSR must not contain domain names that are not in the domainNames parameter!

The CSR contains domain names not listed in the domainNames parameter.

-163

The CSR must not contain domain names that are not in the list of certificate domain names!

The CSR contains domain names not listed in the certificate’s domain names.

AutoUpdateDCV

-1

Request was not made over https!

The request must use HTTPS protocol.

-2

xxxx is an unrecognised argument!

The provided argument is not recognized.

-3

The xxxx argument is missing!

A required argument is missing from the request.

-4

The value of the xxxx argument is invalid!

The argument value does not meet validation requirements.

-14

An unknown error occurred!

An unspecified error occurred during the request.

-16

Incorrect login details, account is locked, password has expired or your source IP is blocked.

Authentication failed due to incorrect login details, a locked account, an expired password, or a blocked source IP address.

-17

Request used GET rather than POST!

The request method should be POST.

-47

domainName is already validated!

The specified domain name has already been validated.

-139

Unexpected certificate state!

The certificate is in an unexpected state.

-160

The attempt to update the DCV method(s) did not succeed.

The DCV method update failed due to a general error.

ResendDCVEmail

-1

Request was not made over https!

The request must use HTTPS protocol.

-2

xxxx is an unrecognised argument!

The provided argument is not recognized.

-3

The xxxx argument is missing!

A required argument is missing from the request.

-4

The value of the xxxx argument is invalid!

The argument value does not meet validation requirements.

-14

An unknown error occurred!

An unspecified error occurred during the request.

-16

Incorrect login details, account is locked, password has expired or your source IP is blocked.

Authentication failed due to incorrect login details, a locked account, an expired password, or a blocked source IP address.

-17

Request used GET rather than POST!

The request method should be POST.

GetDCVEmailAddressList

-1

Request was not made over https!

The request must use HTTPS protocol.

-2

Unrecognised argument!

The provided argument is not recognized.

-3

The xxxx argument is missing!

A required argument is missing from the request.

-4

The value of the xxxx argument is invalid!

The argument value does not meet validation requirements.

-14

An unknown error occurred!

An unspecified error occurred during the request.

-16

Incorrect login details, account is locked, password has expired or your source IP is blocked.

Authentication failed due to incorrect login details, a locked account, an expired password, or a blocked source IP address.

-17

Request used GET rather than POST!

The request method should be POST.

-19

The Domain Name may not be an Internet-accessible IP Address!

Domain names must not be Internet-accessible IP addresses.

-37

The Domain Name is an Intranet Server Name or Intranet IP Address!

Domain names must not be intranet server names or intranet IP addresses.

-91

Permission Denied. Not allowed to use the AUTO-Apply service.

The user is not permitted to use the AUTO-Apply service.

GetDetailedOrderStatus

-1

Request was not made over https!

The request must use HTTPS protocol.

-2

xxxx is an unrecognised argument!

The provided argument is not recognized.

-3

The xxxx argument is missing

A required argument is missing from the request.

-4

The value of the xxxx argument is invalid!

The argument value does not meet validation requirements.

-14

An unknown error occurred!

An unspecified error occurred during the request.

-16

Permission denied!

Authentication failed due to permission issues.

-17

Request used GET rather than POST!

The request method should be POST.

getPostPaymentStatus

-1

Request was not made over https!

The request must use HTTPS protocol.

-2

<errorItem> is an unrecognised argument!

The provided argument is not recognized.

-3

The <errorItem> argument is missing!

A required argument is missing from the request.

-4

The value of the <errorItem> argument is invalid!

The argument value does not meet validation requirements.

-14

An unknown error occurred!

An unspecified error occurred during the request.

-16

Incorrect login details, account is locked, password has expired or your source IP is blocked.

Authentication failed due to incorrect login details, a locked account, an expired password, or a blocked source IP address.

-17

Request used GET rather than POST!

The request method should be POST.

-42

Call limit reached! Please try again later

The maximum number of allowed API requests has been exceeded. Please wait before submitting additional requests.

-43

Certificate is not in a revocable state

The certificate cannot be revoked in its current state.

-160

Failed to revoke certificate.

The certificate revocation failed due to a general error.

initCustomerSession

-1

Request was not made over https!

The request must use HTTPS protocol.

-2

xxxx is an unrecognised argument!

The provided argument is not recognized.

-3

The xxxx argument is missing!

A required argument is missing from the request.

-4

The value of the xxxx argument is invalid!

The argument value does not meet validation requirements.

-14

An unknown error occurred!

An unspecified error occurred during the request.

-16

Incorrect login details, account is locked, password has expired or your source IP is blocked.

Authentication failed due to incorrect login details, a locked account, an expired password, or a blocked source IP address.

-17

Request used GET rather than POST!

The request method should be POST.

-42

Call limit reached! Please try again later

The maximum number of allowed API requests has been exceeded. Please wait before submitting additional requests.

-43

Certificate is not in a revocable state

The certificate cannot be revoked in its current state.

-160

Failed to revoke certificate.

The certificate revocation failed due to a general error.