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 are the results of the ADDDOMAIN and EXTENDDOMAINS actions, and the REMOVEDOMAIN action if it resulted in an automatic refund. It includes all actions that can affect your account balance.

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

Data Description

Subscription Start Date

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

Subscription Expiry Date

Displays the timestamp of the relevant subscription expiry for this 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

    The refundDomain transaction 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:

  • ADDDOMAINS

  • EXTENDDOMAINS

  • REFUNDDOMAIN

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'

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 without data
{
  "subscriptions": []
}