Extend a subscription

The EXTENDDOMAINS action extends the subscription for all domains added to the specified ACME account, and to any other ACME accounts that share the same external account binding details.

This action can only be performed within the subscription extension window, which begins 100 days before the subscription expiration and ends 30 days after the subscription expiration.

The subscription can be extended for 1, 2, or 3 years.

For more information about subscription extensions, see Subscription overview.

Action: EXTENDDOMAINS

Variable Name Type Max. Length Description

loginName

string

64 chars

Your account username.

This value is case sensitive.

loginPassword

string

128 chars

Your account password.

This value is case sensitive.

action

string

30 chars

The action to be taken.

In this case, the value is: EXTENDDOMAINS.

acmeAccountID

string

32 chars

Your Base64 url encoded ACME account ID.

quoteOnly

string

1 char

Indicates whether to return a quote or perform the actual action.

The possible values are:

  • N — (Default) Performs the actual EXTENDDOMAINS action.

  • Y — Returns a quote for the requested action, valid at the time of request, but does not perform any action.

years

integer

Specifies the subscription duration in years.

The possible values are: 1, 2, 3.

If not specified, the value defaults to 1 year.

days

integer

Specifies the subscription duration in days.

The possible values are: 365, 730, 1095.

This is an alternative to the years parameter. Either parameter may be used, but if both years and days are provided, only the years parameter is used.

Sample request

curl --location --request POST 'https://secure.trust-provider.com/products/!ACMEAdmin' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'loginName=loginName' \
--data-urlencode 'loginPassword=loginPassword' \
--data-urlencode 'action=EXTENDDOMAINS' \
--data-urlencode 'acmeAccountID=ABc_123xYZ456' \
--data-urlencode 'years=3'

Success responses

Success response
{
"success": true,
"orderNumber": 7654321,
"cost": 1000,
// displayed price is for sample purposes only
"currency": "USD"
}
Success response with quoteOnly set to Y
{
"success": true,
"cost": 1000.00,
// displayed price is for sample purposes only
"currency": "USD"
}