Unsuccessful responses

Errors

Error responses contain an HTTP/1.1 status code, type, and detail.

Example error response

{
    "type": "urn:sectigo:params:acme:error:malformed",
    "detail": "The 'acmeAccountID' argument is missing!"
}

Response parameters

Name Type Description

type

string

An error code specifying the nature of the error.

detail

string

A description of the error.

Error codes

HTTP Status Code Type Detail Description

400

urn:sectigo:params:acme:error:malformed

'xxxx' is an unrecognized argument!

The {xxxx} argument was not recognized and needs correction.

400

urn:sectigo:params:acme:error:malformed

The 'xxxx' argument is missing!

The provided value for the {xxxx} argument is missing.

400

urn:sectigo:params:acme:error:malformed

The value of the 'xxxx' argument is invalid!

The provided value for the {xxxx} argument is invalid.

400

urn:sectigo:params:acme:error:malformed

Base64url-encoding failed!

This error indicates a failure to perform Base64url encoding.

401

urn:sectigo:params:acme:error:unauthorized

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

Authentication has failed due to one of the specified reasons. Verify your login credentials or check account restrictions.

403

urn:sectigo:params:acme:error:unauthorized

Use of HTTPS is REQUIRED!

HTTPS must be used for the request, which is a secure way of conveying data over the internet.

403

urn:sectigo:params:acme:error:unauthorized

Account could not be deactivated!

The account with this status cannot be deactivated.

403

urn:sectigo:params:acme:error:unauthorized

Domain could not be removed!

The most probable reason for a failure of this request is an attempt to remove the domain after the subscription extension period is over.

403

urn:sectigo:params:acme:error:unauthorized

Not applicable for DV!

This request is not applicable for Domain Validation (DV) certificate issuance.

403

urn:sectigo:params:acme:error:unauthorized

Permission Denied! Contact Support.

You do not have the required permissions. Contact support for further assistance.

403

urn:sectigo:params:acme:error:unauthorized

Subscription Error: No subscription found within the renewal period.

Your subscription has either expired, is beyond the extension window, or does not exist.

403

urn:sectigo:params:acme:error:unauthorized

Pricing band for subscription is not configured for this account. Please contact support.

The account is missing pricing configuration for the subscription. Contact support for details.

403

urn:sectigo:params:acme:error:unauthorized

Subscription price is misconfigured.

The prices set in the applicable pricing band need to be verified and updated.

403

urn:sectigo:params:acme:error:unauthorized

Account could not be debited.

The account has insufficient funds and could not be debited. Please check account status and balance, and top up funds to be able to proceed.

403

urn:sectigo:params:acme:error:unauthorized

Tier 1 account could not be debited.

The Tier 1 account failed to process a debit transaction. Contact support for details.

403

urn:sectigo:params:acme:error:unauthorized

Tier 1 account could not be credited.

The Tier 1 account reached its credit limit. Contact support for details.

403

urn:sectigo:params:acme:error:unauthorized

Partner Account ID is required.

The Partner Account ID is missing from the request. Provide the required ID to proceed.

403

urn:sectigo:params:acme:error:unauthorized

ACME Account ID is required.

The acmeAccountID parameter is mandatory but was not provided. Include it in your request.

403

urn:sectigo:params:acme:error:unauthorized

Domain Name is required.

The domainName parameter is missing. Provide a valid domain name to continue.

403

urn:sectigo:params:acme:error:unauthorized

Duplicate active subscriptions detected. Please contact support.

Multiple active subscriptions conflict has occurred. Contact support for details.

403

urn:sectigo:params:acme:error:unauthorized

Renew the subscription before attempting to add a new domain.

The subscription must be extended within the extension window before adding new domains.

403

urn:sectigo:params:acme:error:unauthorized

Subscription is invalid or renewal window has closed.

The subscription is either invalid, or cannot be extended as the extension window is over. Start a new subscription.

403

urn:sectigo:params:acme:error:unauthorized

Domain Name is missing in the subscription.

The specified domain name is not found in the current subscription.

403

urn:sectigo:params:acme:error:unauthorized

Conflicting subscriptions found during renewal. Please contact support.

Multiple subscriptions are causing conflicts during the extension process. Contact support for details.

403

urn:sectigo:params:acme:error:unauthorized

No subscription eligible for renewal was found.

There is no subscription currently within the extension eligibility window.

403

urn:sectigo:params:acme:error:unauthorized

No active domains linked to the subscription. Begin by adding domains to activate.

The subscription has no domain names. Add at least one domain name to proceed.

403

urn:sectigo:params:acme:error:unauthorized

Subscription Error: The domain name is already present in the subscription.

The domain you are trying to add is already present in the active subscription.

403

urn:sectigo:params:acme:error:unauthorized

Subscription has expired.

The requested action cannot be performed as the subscription has already expired.

405

urn:sectigo:params:acme:error:malformed

Request used GET rather than POST!

The HTTP method that must be used for this request is POST (instead of GET).

429

urn:sectigo:params:acme:error:rateLimited

Rate limit exceeded!

You have exceeded the allowed number of requests within a certain timeframe.

500

urn:sectigo:params:acme:error:serverInternal

The server experienced an internal error!

An unexpected error occurred on the server.