List transactions

The LISTTRANSACTIONS action lists the transactions related to the External Account Binding details identified by the provided ACME account ID.

The transactions included in this report depend on the subscription model and may include the results of subscription-related actions, such as ADDDOMAIN, EXTENDDOMAINS, REMOVEDOMAIN, ADDBUNDLE, and CANCELSUBSCRIPTION. It includes all actions that affect your account balance.

The response provides details about your current subscription(s) or all subscriptions, including past ones, along with the associated transactions.

For bundle-based subscriptions, the response also includes capacity information for each supported domain type (fqdn and wildcard), including purchased, used, and available domain slots.

Data Description

Subscription Start Date

Displays the timestamp of the relevant subscription start for these EAB details.

Subscription Expiry Date

Displays the timestamp of the relevant subscription expiry for these EAB details.

  • For expired subscriptions, it shows the final end date/time.

  • For the current subscription, it shows the current expiry date/time.

Subscription Status

Indicates whether the subscription is currently valid.

Transaction Type

The possible values are:

  • addDomain

  • extendDomains

  • refundDomain

  • addBundle

  • refundBundle

    The refundBundle transaction is only relevant for the bundle-based subscription model and occurs as a result of the cancelSubscription action when the following conditions are met:

  • The time between adding the first bundle and cancelling the subscription is less than 30 days.

    The refundDomain transaction is only relevant for the standalone domain model and occurs as a result of the removeDomain action when the following conditions are met:

    • The time between adding and removing the domain is less than 30 days.

Transaction Date

The timestamp indicating when this operation was executed.

Domain Name(s)

A list of domain names that the transaction was performed on.

Domain Type(s)

A list of domain types that the transaction was performed on.

The possible values are:

  • Wildcard

  • FQDN (fully qualified domain name)

Cost

The cost debited or refunded as a result of this transaction.

When filtering by domainName, the cost shown for a particular extendDomains transaction represents the amount debited for the filtered domain name, not the entire transaction.

Currency

The currency in which the cost was debited or refunded.

Debited For

The number of days for which the cost was debited or refunded.

Order Number

The order number generated as a result of this transaction.

Remove Date

The timestamp of the execution of the REMOVEDOMAIN action for this domain name, associated with the given order number.

  • Relevant for addDomain and refundDomain transactions.

  • Not applicable for extendDomains transactions that affect multiple domain names.

Action: LISTTRANSACTIONS

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: LISTTRANSACTIONS.

acmeAccountID

string

32 chars

Your Base64 URL-encoded ACME account ID.

showAllSubscriptions

string

1 char

(Optional) Specifies whether to retrieve the list of transactions for all subscriptions that have ever existed for these EAB details or only for the current valid subscription.

The possible values are:

  • N — (Default) Include only active subscription.

  • Y — Include all subscriptions for this acmeAccountID.

transactionDateFrom

string

20 chars

(Optional) Include only transactions processed from this date/time.

The format is: YYYY-MM-DDTHH:MI:SSZ.

transactionDateTo

string

20 chars

(Optional) Include only transactions processed before this date/time.

The format is: YYYY-MM-DDTHH:MI:SSZ.

transactionType

string

30 chars

(Optional) Include only transactions of this type.

The possible values are:

  • ADDDOMAIN

  • EXTENDDOMAINS

  • REFUNDDOMAIN

  • ADDBUNDLE

  • REFUNDBUNDLE

domainName

string

255 chars

(Optional) Include only transactions for this domain name.

orderNumber

string

128 chars

(Optional) Include only transaction processed under this order number.

page

integer

(Optional) 0-based page index.

size

integer

(Optional) Number of elements per page.

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=LISTTRANSACTIONS' \
--data-urlencode 'acmeAccountID=ABc_123xYZ456'

Response

Response parameters

The response may contain the following parameters:

Parameter Type Description

subscriptions

array

An array of subscription objects.

The beginning of the subscriptions array

subscriptionStartDate

string

The timestamp of the relevant subscription start for these EAB details.

subscriptionEndDate

string

The timestamp of the relevant subscription expiry for these EAB details.

subscriptionType

string

The type of subscription.

isActive

boolean

Indicates whether the subscription is currently valid.

transactions

array

An array of transaction objects.

The beginning of the Transactions array

transactionType

string

The type of transaction performed.

transactionDate

string

The timestamp indicating when this operation was executed.

domains

array

A list of domain names and types that the transaction was performed on.

The beginning of the domains array

type

string

The type of domain.

name

string

The domain name.

cost

number

The cost debited or refunded as a result of this transaction.

currency

string

The currency in which the cost was debited or refunded.

debitedFor

number

The number of days for which the cost was debited or refunded.

debitedForStartDate

string

The start date of the period for which the cost was debited or refunded.

debitedForEndDate

string

The end date of the period for which the cost was debited or refunded.

orderNumber

string

The order number generated as a result of this transaction.

removeDate

string

The timestamp of the execution of the REMOVEDOMAIN action for this domain.

limits

array

An array of limit objects for a bundle-based subscription.

The beginning of the limits array

domainType

string

The type of domain for which the limit applies.

totalSlots

number

The total number of slots purchased for this domain type.

usedSlots

number

The number of slots currently in use for this domain type.

availableSlots

number

The remaining available capacity of slots for this domain type.

extensionPendingSlots

number

The number of slots that were returned to the Wallet after removing domains during the extension period and which are pending subscription extension to be re-used.

bundles

array

An array of bundle objects for a bundle-based subscription.

The beginning of the bundles array

domainType

string

The type of domain included in this bundle.

numberOfDomains

number

The number of domains included in this bundle.

Sample success responses

Success response with data
{
  "subscriptions": [
    {
      "subscriptionStartDate": "2023-11-16T10:04:20Z",
      "subscriptionEndDate": "2024-11-15T23:59:59Z",
      "isActive": false,
      "transactions": [
        {
          "transactionType": "addDomain",
          "transactionDate": "2023-12-06T12:54:20Z",
          "domains": [
            {
              "name": "domain.com",
              "type": "fqdn"
            }
          ],
          "cost": 1111.78,
          // displayed price is for sample purposes only
          "currency": "USD",
          "debitedFor": 345,
          "debitedForStartDate": "2023-12-07T00:00:00Z",
          "debitedForEndDate": "2024-11-15T23:59:59Z",
          "orderNumber": "12345678",
          "removeDate": "2024-08-06T12:54:20Z"
        }
      ]
    },
    {
      "subscriptionStartDate": "2024-11-16T10:04:20Z",
      "subscriptionEndDate": "2025-11-16T23:59:59Z",
      "isActive": true,
      "transactions": [
        {
          "transactionType": "addDomain",
          "transactionDate": "2024-12-07T12:54:20Z",
          "domains": [
            {
              "name": "blog.domain.com",
              "type": "fqdn"
            }
          ],
          "cost": 1011.78,
          // displayed price is for sample purposes only
          "currency": "USD",
          "debitedFor": 344,
          "debitedForStartDate": "2024-12-08T00:00:00Z",
          "debitedForEndDate": "2025-11-16T23:59:59Z",
          "orderNumber": "87654321",
          "removeDate": ""
        }
      ]
    }
  ]
}
Success response with bundle capacity information
{
  "subscriptions": [
    {
      "subscriptionStartDate": "2026-06-01T00:00:00Z",
      "subscriptionEndDate": "2027-06-01T23:59:59Z",
      "subscriptionType": "bundle",
      "isActive": true,
      "limits": [
        {
          "domainType": "single",
          "totalSlots": 10,
          "usedSlots": 3,
          "availableSlots": 7,
          "extensionPendingSlots": 2
        },
        {
          "domainType": "wildcard",
          "totalSlots": 5,
          "usedSlots": 1,
          "availableSlots": 4
        }
      ],
      "transactions": [
        {
          "transactionType": "addBundle",
          "transactionDate": "...",
          "cost": 400.00,
          // displayed price is for sample purposes only
          "currency": "USD",
          "orderNumber": 12345,
          "bundles": [
            { "domainType": "fqdn", "numberOfDomains": 5 }
          ]
        },
        {
          "transactionType": "addDomain",
          "domains": [
            { "name": "example.com", "type": "fqdn" }
          ]
        }
      ]
    }
  ]
}
Success response without data
{
  "subscriptions": []
}