---
title: "Get Transactions"
method: GET
path: "/accounts/{account_id}/transactions"
tags: ["Money + Positions"]
---

# Get Transactions

`GET /accounts/{account_id}/transactions`

## Request

- Base URL: `https://sandbox.api.lemon.markets/v1`
- URL: `https://sandbox.api.lemon.markets/v1/accounts/{account_id}/transactions`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api/docs/accounts/:account_id/transactions/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `account_id` string, required

## Query parameters

- `cursor` string
- `limit` integer

## Headers

- `LMG-Data-Privacy-Access-Principal` string, required
- `LMG-Data-Privacy-Access-Justification` string, required

## Response `200`

Successful Response

- PageTransaction
  - `data` Transaction[], required: The elements of the response.
    - `id` string, required: A string representing the unique identifier of this transaction.
    - `status` 'canceled' | 'created' | 'settled', required: A category representing a transaction status: <ul> <li><code>canceled</code>: The transaction was canceled. <li><code>created</code>: The transaction was created and is not settled yet. <li><code>settled</code>: The transaction is settled. </ul>
    - `type` 'corporate_action' | 'deposit' | 'income_distribution' | 'securities_transfer' | 'sweep' | 'tax' | 'trade' | 'withdrawal', required: A category representing a transaction type: <ul> <li><code>corporate_action</code>: Corporate Action (eg. a Cash Dividend) <li><code>deposit</code>: Cash Deposit <li><code>income_distribution</code>: Income Distribution <li><code>securities_transfer</code>: Securities Transfer <li><code>sweep</code>: Balance Sweep <li><code>tax</code>: Tax Payment <!--or Credit--> <li><code>trade</code>: Trade <li><code>withdrawal</code>: Cash Withdrawal </ul>
    - `source` string, required: An opaque identifier referencing the source of the transaction.
    - `components` TransactionComponent[], required
      - union: A component of a transaction. It indicates changes to the positions or funds affected by a transaction.
        - CashComponent: An object representing the cash component of a transaction.
          - `type` 'cash' | 'securities', required: A category representing a component type: <ul> <li><code>cash</code>: Cash component; this component modifies the customer's cash balance. <li><code>securities</code>: Securities component; this component modified a customer's position. </ul>
          - `direction` 'debit' | 'credit', required: A category representing a component direction: <ul> <li><code>credit</code>: Assets for the customer. The amount/quanity will be added to the balance/position. <li><code>debit</code>: Liabilities for the customer. The amount/quantity will be subtracted from the balance/position. </ul>
          - `currency` string, required: An ISO 4217 three-letter currency code. Its value represents the currency for the amount listed. The only currently available currency is `"EUR"`.
          - `amount` number, required: The amount of cash being moved in this transaction component.
        - SecuritiesComponent: An object representing an instrument-related component of a transaction.
          - `type` 'cash' | 'securities', required: A category representing a component type: <ul> <li><code>cash</code>: Cash component; this component modifies the customer's cash balance. <li><code>securities</code>: Securities component; this component modified a customer's position. </ul>
          - `direction` 'debit' | 'credit', required: A category representing a component direction: <ul> <li><code>credit</code>: Assets for the customer. The amount/quanity will be added to the balance/position. <li><code>debit</code>: Liabilities for the customer. The amount/quantity will be subtracted from the balance/position. </ul>
          - `instrument` string, required: An ISIN (International Securities Identification Number) according to ISO 6166. This value uniquely identifies the instrument of this component.
          - `quantity` number, required: The number of shares affected by this component.
    - `history` StatusChangeTransactionStatus[], required: A history of the status changes for a transaction.
      - `status` 'canceled' | 'created' | 'settled', required: A category representing a transaction status: <ul> <li><code>canceled</code>: The transaction was canceled. <li><code>created</code>: The transaction was created and is not settled yet. <li><code>settled</code>: The transaction is settled. </ul>
      - `timestamp` string, date-time, required: The timestamp of the event. It represents the point in time at which the transaction was updated.
  - `pagination` Pagination, required: Information about accessing elements beyond the ones that were returned.
    - `next_cursor` string: When fetching long lists of elements, you can use our pagination feature to fetch batches of data. If a response contains the property `pagination.next_cursor`, you can pass its value via the query item `cursor` to generate the request for the next batch of data.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `404`: Not Found
- `422`: Unprocessable Entity
- `5XX`: Server Error

## Changes

- **2026-11-03** `1f1df208c0e4`: 1 warning
  - added the new `corporate_action` enum value to the `data/items/type` response property for the response status `200`

[Operation history](https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api/changes/accounts/:account_id/transactions/get.md)

---

[API](https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api.md) - [All operations](https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api/revisions/1f1df208c0e4?raw)