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

# Get Transaction

`GET /accounts/{account_id}/transactions/{transaction_id}`

## Request

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

## Path parameters

- `account_id` string, required
- `transaction_id` string, required

## Headers

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

## Response `200`

Successful Response

- Transaction
  - `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.

## 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 `type` response property for the response status `200`

[Operation history](https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api/changes/accounts/:account_id/transactions/:transaction_id/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)