> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tesouro.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Transactions

> Read the historical ledger for an embedded bank account.

A transaction is a posted entry in a bank account's ledger — a movement of funds in or out of the account, with the running balance after the post. Transactions are read-only; they are produced by upstream activity (transfers, fees, returns) and surfaced for reconciliation, statements, and end-user history.

```http lines theme={null}
GET /embedded-banking/v1/bank-accounts/{id}/transactions
```

Required scope: `bank_account:read:org`.

## On this guide

| Page                                                                  | What it covers                                                                   |
| :-------------------------------------------------------------------- | :------------------------------------------------------------------------------- |
| [Record shape](/embedded-banking/guides/transactions/record-shape)    | The fields on a transaction record and the unsigned-amount + direction rule.     |
| [Pagination](/embedded-banking/guides/transactions/pagination)        | The cursor contract, sweep loop, and the opaque-token rule.                      |
| [Filtering](/embedded-banking/guides/transactions/filtering)          | Date-range filters supported by this endpoint and how they interact with paging. |
| [CSV download](/embedded-banking/guides/transactions/downloading-csv) | Stream a date range as a ready-to-import, QuickBooks-compatible CSV file.        |

## Real-time updates

This endpoint is the on-demand view of the ledger. For push notifications when a new entry posts (or fails to post), subscribe to ledger webhook events — see [Webhooks: event types](/embedded-banking/guides/webhooks/event-types#ledger_transaction).
