# 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](../../../../guides/billing/credentials.md) for the user who owns the billing account. Follow [Query accounts and billing settings](accounts.md) to obtain the target account ID. For service URLs and authentication, see [Service URLs and authentication](../../../../reference/api/genesis/index.md#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](../../../../reference/api/genesis/billing/transactions/list.md) | Filter the account's transaction records. |
| Inspect consumption composition | [List consumption aggregates](../../../../reference/api/genesis/billing/transactions/aggregates.md) | Inspect associated usage and charges by time window. |

## Confirm the result

Check transaction direction and balance changes in [List transactions](../../../../reference/api/genesis/billing/transactions/list.md), 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

- [Analyze rated usage and costs](usage.md)
