Query transaction records

Query account transactions and consumption aggregated by time window to inspect balance changes and the composition of spending.

Prerequisites

Prepare a valid personal access token for the user who owns the billing account. Follow Query accounts and billing settings to obtain the target account ID. For service URLs and authentication, see Service URLs and authentication.

Call sequence

  1. List transactions for the required time range and filters to inspect balance changes.

  2. To inspect usage and charges by consumption window, list consumption aggregates.

  3. For additional records, follow each response’s next-page indicator until no further page is available.

API operations

Task

API operation

When to use or what to verify

Inspect balance changes

List transactions

Filter the account’s transaction records.

Inspect consumption composition

List consumption aggregates

Inspect associated usage and charges by time window.

Confirm the result

Check transaction direction and balance changes in List transactions, and inspect charges and source records for the relevant window in consumption aggregates. These lists serve different purposes; their row counts are not the same metric.

Limitations and notes

This task only queries existing records; it does not initiate payments or recharges. Expense transactions have a negative balance change.

Next steps

Last updated on