REST API Error Codes

Error Codes

Whenever there is an error processing your API request, the API will return a straightforward JSON error message carrying a success response object set to false, an error code as well as a text-based error type.

You will find an example error as well as a list of all possible error codes and messages below.

Example Error:

{
    "success": false,
    "error": {
        "code": 2803,
        "type": "certificate_not_found"
    }
}

Errors - General:

Error Code / Type	Description
101 invalid_access_key	101 / invalid_access_key User has provided an invalid API access key.
102 inactive_user	101 / inactive_user You can not authenticate because your account is not active.
103 invalid_api_function	103 / invalid_api_function User has provided an invalid API function.
110 invalid_request_body	110 / invalid_request_body The body of your request was wrong. Please check your request arguments.
111 internal_server_error	111 / internal_server_error Something went wrong. If the problem persists please contact our support team ([email protected]).
112 conflict	112 / conflict The target resource can not be modified.
113 unprocessable_entity	113 / unprocessable_entity The syntax of your request was correct, but your request can not be processed.
114 conflict	114 / conflict The target resource can not be modified.
115 invalid_json_request	115 / invalid_json_request You have sent a JSON request, but it can not be decoded as JSON. Please check your input.
116 invalid_json_request_param	116 / invalid_json_request_param You have sent an illegal parameter in your JSON request. Multidimensional arrays, objects and resources are not allowed.
2800 incorrect_request_type	2800 / incorrect_request_type User has made a non-supported API request.
2801 permission_denied	2801 / permission_denied User does not have the permissions to access this resource.
2802 missing_certificate_hash	2802 / missing_certificate_hash User has not provided a certificate ID (hash).
2803 certificate_not_found	2803 / certificate_not_found The given certificate ID (hash) could not be found.

Errors - Create Certificate:

Error Code / Type	Description
2804 cannot_issue_certificate_unpaid_upgrade_invoices	2804 / cannot_issue_certificate_unpaid_upgrade_invoices The current certificate cannot be issued due to unpaid invoices on user account.
2805 invalid_certificate_type	2805 / invalid_certificate_type User has provided an invalid certificate type.
2806 missing_certificate_type	2806 / missing_certificate_type User has not provided a valid certificate type.
2807 invalid_certificate_validity	2807 / invalid_certificate_validity User has not provided a valid certificate validity.
2808 invalid_certificate_domain	2808 / invalid_certificate_domain User has not provided one or more invalid certificate domains.
2809 wildcard_domains_not_allowed_in_multidomain_certificate	2809 / wildcard_domains_not_allowed_in_multidomain_certificate Wildcards cannot be included in multi-domain certificates.
2810 invalid_domains_in_multidomain_request	2810 / invalid_domains_in_multidomain_request User has not provided one or more invalid domains in multi-domain request.
2811 duplicate_domains_in_array	2811 / duplicate_domains_in_array User has not provided one or more duplicate domains.
2812 missing_certificate_domains	2812 / missing_certificate_domains User has not provided any certificate domains.
2813 cannot_replace_certificate_other_replacement_in_draft	2813 / cannot_replace_certificate_other_replacement_in_draft Only issued certificates can be renewed or replaced by a new certificate.
2814 permission_denied_on_original_certificate	2814 / permission_denied_on_original_certificate User does not have the permissions to access certificate to renew.
2815 original_certificate_not_active	2815 / original_certificate_not_active Only issued certificates can be renewed or replaced by a new certificate.
2816 cannot_find_original_certificate	2816 / cannot_find_original_certificate Certificate to renew was not found.
2817 certificate_limit_reached	2817 / certificate_limit_reached Limit of certificates on user account was reached.
2818 invalid_certificate_csr	2818 / invalid_certificate_csr User has not provided a valid CSR value.
2819 missing_certificate_csr	2819 / missing_certificate_csr User has not provided a CSR value.
2820 internal_error_failed_processing_csr	2820 / internal_error_failed_processing_csr Internal error processing CSR. Please contact support if this error occurs.
2821 internal_error_failed_creating_certificate	2821 / internal_error_failed_creating_certificate Internal error generating certificate. Please contact support if this error occurs.
2836 csr_cn_is_invalid	2836 / csr_cn_is_invalid The CN (= common name) in the CSR has an invalid value. Most probably it is not a valid internet address (domain or IP without protocol). Valid examples: example.com, 127.0.0.1. Please note that the CSRs' CN (common name) should be exactly the first of your certificate_domains parameter. It is recommended to use a fresh, unique and correct CSR for all certificates.
2839 duplicate_certificates_found	2839 / duplicate_certificates_found Domain can no longer be protected using Free Plan, upgrade to Basic Plan required.
2841 certificate_creation_locked_unpaid_invoices	2841 / certificate_creation_locked_unpaid_invoices Your account has been temporarily suspended due to unpaid invoices. Please pay your open invoices in order to unlock this endpoint.

Errors - Verify Domains:

Error Code / Type	Description
2822 failed_showing_certificate	2822 / failed_showing_certificate The requested certificate could not be retrieved.
2823 failed_validating_certificate	2823 / failed_validating_certificate Domain verification failed and must be retried. Possible reasons for this are: You are using a restricted TLD Your domain name is too long (~ 62 characters maximum) Your custom CSR is using a key which is believed to be compromised Please also make sure you know about common verification problems.
2824 missing_validation_emails	2824 / missing_validation_emails User has not provided a validation email for each domain in certificate.
2825 missing_validation_email	2825 / missing_validation_email User has not provided a validation email for each domain in certificate.
2826 internal_error_while_valdating_domain_control	2826 / internal_error_while_valdating_domain_control Internal error verifying domains. Please contact support if this error occurs.
2827 invalid_validation_method	2827 / invalid_validation_method User has provided an in invalid domain verification method.
2828 missing_validation_method	2828 / missing_validation_method User has not provided a domain verification method.
2829 incorrect_certificate_validation_type	2829 / incorrect_certificate_validation_type User has provided an in invalid domain verification method or value.
2830 certificate_not_eligible	2830 / certificate_not_eligible The given certificate is not eligible for domain verification.
2831 certificate_not_ready_to_validate	2831 / certificate_not_ready_to_validate The given certificate is not ready for domain verification.
2840 invalid_caa_records_detected	2840 / invalid_caa_records_detected Invalid CAA records detected for some domains. Array of affected domains can be found in details object. Learn more about CAA records.
2841 caa_record_check_failed	2841 / caa_record_check_failedAn internal error occurred checking your CAA records. If the problem persists please contact our support team ([email protected]).
2874 certificate_restricted_top_level_domain	2874 / certificate_restricted_top_level_domain We are not able to issue certificates for this Top-Level-Domain at the moment. Learn more.
2875 certificate_premium_not_allowed	2875 /certificate_premium_not_allowed You are not allowed to issue premium certificates, most probably due to unpaid invoices or upgrades / downgrades. In case you think this is a mistake please contact the ZeroSSL support team.

Errors - Download Certificate:

Error Code / Type	Description
2832 certificate_not_issued	2832 / certificate_not_issued The given certificate has not been issued yet.
2860 certificate_not_downloadable	2860 / certificate_not_downloadable The certificate can currently not be downloaded.

Errors - Revoke Certificate:

Error Code / Type	Description
2906 revocation_failed	2906 / revocation_failed The certificate can not be revoked currently, please try again later. If the problem persists - especially in urgent cases like key compromise - please contact our support team ([email protected]).
2907 certificate_not_in_revocable_state	2907 / certificate_not_in_revocable_state The certificate is not in a revocable state. Either the state has transitioned in the background, you are trying to revoke a certificate which can not be revoked due to its status or some process is going on in the background. If you think this is a mistake at our side please contact our support team ([email protected]).
2908 certificate_revocation_temporarily_blocked	2908 / certificate_revocation_temporarily_blocked Due customer protection mechanisms, your certificate can not be revoked at the moment. Try again some hours later. We temporarily disable revocation functionality, if high numbers of certificates are revoked. This was implemented as a preventive measure to limit possible loss in case of whatever related incident. Help and further information: ([email protected]).
2909 certificate_not_revocable_being_issued	2909 / certificate_not_revocable_being_issued The certificate can not be revoked / cancelled because it is currently being issued. If this was a mistake, you may revoke it after issuance (most probably in 1-2 minutes).
2910 certificate_not_revocable_already_replaced	2910 / certificate_not_revocable_already_replaced The certificate has already been replaced by a new one. Does not apply for certificates where you have used the standard "renew" functionality of ZeroSSL, can only happen for special cases.

Errors - Cancel Certificate:

Error Code / Type	Description
2833 certificate_cannot_be_cancelled	2833 / certificate_cannot_be_cancelled The given certificate cannot be cancelled due to its status.
2834 failed_cancelling_certificate	2834 / failed_cancelling_certificate Internal error cancelling certificate. Try again or contact support.

Errors - Resend Verification:

Error Code / Type	Description
2837 failed_resending_email	2837 / failed_resending_email Internal error resending verification email. Try again or contact support.

Errors - Get Verification Status:

Error Code / Type	Description
2838 failed_getting_validation_status	2838 / failed_getting_validation_status Error retrieving domain verification status. Try again and make sure Email Verification is selected.