Endpoint: !autoRevokeCertificate

https://secure.trust-provider.com/products/!autoRevokeCertificate

The autoRevokeCertificate API endpoint allows you to revoke a certificate or cancel the order if the certificate has not yet been issued.

Use the POST method for this endpoint.

Submit parameters in the x-www-form-urlencoded format.

The following table lists the required and optional parameters.

Parameter Type Required/Optional Max. Length Description

loginName

string

required

64 chars

Your account username.

This value is case sensitive.

loginPassword

string

required

128 chars

Your account password.

This value is case sensitive.

orderNumber

integer

optional

The order number of the account.

Either orderNumber, certificateID, or serialNumber must be provided.

accountID

integer

optional

Your account ID number.

revocationReason

string

optional

1024 chars

A comment describing the reason for revocation. This information is for your reference only and does not affect processing by Sectigo.

codeReason

integer

required

The code of the reason for revocation.

The possible values are:

  • 0 = Unspecified (default)

  • 1 = keyCompromise

  • 3 = affiliationChanged

  • 4 = Superseded

  • 5 = cessationOfOperation

If omitted, codeReason defaults to 0. For more information, see CPS.

productCode

char

optional

50 chars

Determines the certificate to be revoked.

product

integer

optional

The product code for the certificate to be revoked.

test

char

optional

1 char

Indicates whether the revocation is a test operation. If omitted, test defaults to N.

This value is case sensitive.

responseFormat

integer

optional

1 digit

Specifies the response format.

The possible values are:

  • 0 = text description (default)

  • 1 = text/plain formatted

Sample request

curl --location --request POST 'https://secure.trust-provider.com/products/!AutoRevokeCertificate' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'loginName=yourLoginName' \
--data-urlencode 'loginPassword=yourPassword' \
--data-urlencode 'orderNumber=123456' \
--data-urlencode 'codeReason=1' \
--data-urlencode 'revocationReason=Key compromised' \
--data-urlencode 'responseFormat=0'

Success response

// format-specific certificate output