---
title: "List cash transactions"
method: GET
path: "/transactions/cash"
tags: ["Transactions"]
---

# List cash transactions

`GET /transactions/cash`

## Request

- Base URL: `https://sandbox.upvest.co`
- URL: `https://sandbox.upvest.co/transactions/cash`
- Auth: OAuth 2 (client credentials, token URL `https://sandbox.upvest.co/auth/token`, scopes: `transactions:read`)

Returns the list of cash transactions for an account group.

Cash movements are recorded at account group level, so this endpoint is filtered by `account_group_id` rather than by account. Restrict the period with the `start_date` and `end_date` query parameters, and page through results with `offset` and `limit`; `meta.total_count` gives the total number of matching transactions.

See the transactions reports guide ([TOL](https://docs.upvest.co/products/tol/guides/reports/account_reports_transactions) / [BYOL](https://docs.upvest.co/products/byol/guides/reports/account_reports_transactions) / [Omnibus](https://docs.upvest.co/products/omnibus/guides/reports/account_reports_transactions)) for the full list of transaction types.

## Query parameters

- `account_group_id` string, uuid: Universally Unique Identifier (UUID) of the account group.
- `start_date` string, date: Returns transactions starting from and including this date (UTC).
- `end_date` string, date: Returns transactions up until this date (UTC)
- `sort` 'booking_date'
- `order` 'ASC' | 'DESC'
- `offset` integer
- `limit` integer

## Response `200`

Cash Transactions

- object: Paginated list of cash transactions. Contains a `data` array of cash transaction objects and a `meta` object with offset/limit pagination metadata.
  - `meta` object, required: Offset/limit pagination metadata for a list response. Contains the `offset` and `limit` applied to the request, the `count` of resources returned in this page, and the `total_count` of matching resources.
    - `offset` integer, required: Amount of resource to offset in the response.
    - `limit` integer, required: Total limit of the response.
    - `count` integer, required: Count of the resources returned in the response.
    - `total_count` integer, required: Total count of all the resources.
    - `sort` string: The field that the list is sorted by.
    - `order` 'ASC' | 'DESC': The ordering applied to the list. * ASC — Ascending order. * DESC — Descending order.
  - `data` object[], required: The cash transactions in this page of results.
    - `account_group_id` string, uuid, required: Universally Unique Identifier (UUID) of the account group.
    - `booking_date` string, date-time, required: Transaction booking date and time. [RFC 3339-5](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6), [ISO8601 UTC](https://www.iso.org/iso-8601-date-and-time-format.html)
    - `created_at` string, date-time, required: Date and time when the resource was created. [RFC 3339-5](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6), [ISO8601 UTC](https://www.iso.org/iso-8601-date-and-time-format.html)
    - `delta` object, required: Entity representing cash transaction delta.
      - `amount` string, required
      - `currency` 'EUR' | 'GBP' | 'USD', required: Alphabetic three-letter [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html) currency code. * EUR — Euro. * GBP — Pound Sterling. * USD — The United States dollar.
    - `id` string, uuid, required: Cash transaction unique identifier.
    - `instrument` object: Entity representing instrument.
      - `uuid` string, uuid, required: Internal instrument identifier.
      - `isin` string: International securities identification number defined by [ISO 6166](https://en.wikipedia.org/wiki/International_Securities_Identification_Number).
    - `account_id` string, uuid: Universally Unique Identifier (UUID) of the account.
    - `taxes` object[], required: The taxes applied to this transaction.
      - `amount` string, required
      - `currency` 'EUR' | 'GBP' | 'USD', required: Alphabetic three-letter [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html) currency code. * EUR — Euro. * GBP — Pound Sterling. * USD — The United States dollar.
      - `type` 'TOTAL', required: What the tax figure covers. * TOTAL — Total taxes.
    - `taxes_details` object, required: Entity representing the transaction taxes details.
      - `total_amount` object, required: The total tax amount, with its currency.
        - `amount` string, required
        - `currency` 'EUR' | 'GBP' | 'USD', required: Alphabetic three-letter [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html) currency code. * EUR — Euro. * GBP — Pound Sterling. * USD — The United States dollar.
      - `tax_breakdown` object[], required: The individual tax components making up the total.
        - `amount` string, required
        - `currency` 'EUR' | 'GBP' | 'USD', required: Alphabetic three-letter [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html) currency code. * EUR — Euro. * GBP — Pound Sterling. * USD — The United States dollar.
        - `type` 'CAPITAL_GAINS' | 'CHURCH_TAX' | 'SOLIDARITY_SURCHARGE' | 'FINANCIAL_TRANSACTION_TAX' | 'STAMP_DUTY' | 'INTERNATIONAL_WITHHOLDING_TAX', required: The kind of tax this component represents. * CAPITAL_GAINS — Capital gains tax. * CHURCH_TAX — German church tax (Kirchensteuer). * SOLIDARITY_SURCHARGE — German solidarity surcharge (Solidaritätszuschlag). * FINANCIAL_TRANSACTION_TAX — Financial transaction tax. * STAMP_DUTY — Stamp duty. * INTERNATIONAL_WITHHOLDING_TAX — Withholding tax levied in another jurisdiction.
        - `taxing_jurisdiction` string, required: Country code. [ISO 3166 alpha-2 Codes](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
    - `fees` object[]: The fees applied to this transaction.
      - `amount` string, required
      - `currency` 'EUR' | 'GBP' | 'USD', required: Alphabetic three-letter [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html) currency code. * EUR — Euro. * GBP — Pound Sterling. * USD — The United States dollar.
      - `type` 'TOTAL', required: What the fee figure covers. * TOTAL — Total fees.
      - `charge_method` 'CHARGED_BY_CLIENT' | 'COLLECTED_BY_UPVEST' | 'CHARGED_BY_CLIENT_NET', required: How the fee was charged. * CHARGED_BY_CLIENT — Charged by client. * COLLECTED_BY_UPVEST — Charged by client and collected by Upvest. * CHARGED_BY_CLIENT_NET — Charged and collected by client; the fee is deducted from the transaction amount.
    - `fx` object: Entity representing the applied FX rate for a cash transaction. Present only for corporate action cash transactions where the distribution currency differs from the source/income currency. Omitted for every other transaction type, and also for domestic transactions where those currencies match (no conversion occurred).
      - `base_currency` 'EUR' | 'GBP' | 'USD', required: Alphabetic three-letter [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html) currency code. * EUR — Euro. * GBP — Pound Sterling. * USD — The United States dollar.
      - `quote_currency` 'EUR' | 'GBP' | 'USD', required: Alphabetic three-letter [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html) currency code. * EUR — Euro. * GBP — Pound Sterling. * USD — The United States dollar.
      - `rate` object, required: Entity representing the applied FX rate for a currency conversion.
        - `all_in_rate` string, required: A positive decimal amount, as a string.
        - `base_rate` string, required: A positive decimal amount, as a string.
        - `markup_rate` string, required: A positive decimal amount, as a string.
    - `references` object[], required: Identifiers of the resources that this transaction relates to, such as the order or fee collection that caused it.
      - `id` string, uuid, required: Unique identifier for a resource of given type.
      - `type` 'ACCOUNT_GROUP' | 'CASH_BALANCE_TRANSFER' | 'CORPORATE_ACTION' | 'CORPORATE_ACTION_TRANSACTION_ID' | 'CREDIT_FUNDING' | 'DIRECT_DEBIT' | 'EXTERNAL_DIRECT_DEBIT' | 'FEE_COLLECTION' | 'ISA_TRANSFER' | 'ORDER' | 'ORDER_EXECUTION' | 'PENSION_DE_ALLOWANCE' | 'PENSION_DE_ALLOWANCE_UPDATE' | 'TAX_TRANSACTION' | 'TOPUP' | 'TRANSACTION_FEE_EXECUTION' | 'VIRTUAL_CASH_DECREASE' | 'VIRTUAL_CASH_INCREASE' | 'WITHDRAWAL', required: Type of the reference. * ACCOUNT_GROUP - Account group * CASH_BALANCE_TRANSFER - Cash balance transfer * CORPORATE_ACTION - Corporate action * CORPORATE_ACTION_TRANSACTION_ID - Corporate action transaction ID * CREDIT_FUNDING - Credit Funding * DIRECT_DEBIT - Direct debit funding request * EXTERNAL_DIRECT_DEBIT - External direct debit collection * FEE_COLLECTION - Fee collection * ISA_TRANSFER - ISA transfer * ORDER - Order * ORDER_EXECUTION - Order execution * PENSION_DE_ALLOWANCE - German pension allowance * PENSION_DE_ALLOWANCE_UPDATE - German pension allowance update * TAX_TRANSACTION - Tax transaction * TOPUP - Cash top up * TRANSACTION_FEE_EXECUTION - Transaction fee execution * VIRTUAL_CASH_DECREASE - Virtual cash decreased * VIRTUAL_CASH_INCREASE - Virtual cash increased * WITHDRAWAL - Cash withdrawal
    - `type` 'ACCUMULATION' | 'ACCUMULATION_CANCELLATION' | 'ANNUAL_GENERAL_MEETING' | 'ANNUAL_GENERAL_MEETING_CANCELLATION' | 'ATTACHMENT' | 'ATTACHMENT_CANCELLATION' | 'BALANCE_CORRECTION' | 'BALANCE_CORRECTION_CANCELLATION' | 'BANKRUPTCY' | 'BANKRUPTCY_CANCELLATION' | 'BOND_DEFAULT' | 'BOND_DEFAULT_CANCELLATION' | 'BOND_HOLDER_MEETING' | 'BOND_HOLDER_MEETING_CANCELLATION' | 'BONUS_ISSUE' | 'BONUS_ISSUE_CANCELLATION' | 'CALL_ON_INTERMEDIATE_SECURITIES' | 'CALL_ON_INTERMEDIATE_SECURITIES_CANCELLATION' | 'CAPITAL_DISTRIBUTION' | 'CAPITAL_DISTRIBUTION_CANCELLATION' | 'CAPITAL_GAINS_DISTRIBUTION' | 'CAPITAL_GAINS_DISTRIBUTION_CANCELLATION' | 'CAPITALISATION' | 'CAPITALISATION_CANCELLATION' | 'CASH_DISTRIBUTION_FROM_NON_ELIGIBLE_SECURITIES_SALES' | 'CASH_DISTRIBUTION_FROM_NON_ELIGIBLE_SECURITIES_SALES_CANCELLATION' | 'CASH_DIVIDEND' | 'CASH_DIVIDEND_CANCELLATION' | 'CHANGE' | 'CHANGE_CANCELLATION' | 'CLASS_ACTION' | 'CLASS_ACTION_CANCELLATION' | 'COMPANY_OPTION' | 'COMPANY_OPTION_CANCELLATION' | 'CONSENT' | 'CONSENT_CANCELLATION' | 'CONVERSION' | 'CONVERSION_CANCELLATION' | 'COURT_MEETING' | 'COURT_MEETING_CANCELLATION' | 'CREDIT_EVENT' | 'CREDIT_EVENT_CANCELLATION' | 'CREDIT_FUNDING' | 'CREDIT_FUNDING_CHARGE_BACK' | 'DD_REFUND_REJECT_FEE' | 'DD_REFUND_REJECT_FEE_CANCELLATION' | 'DECREASE_IN_VALUE' | 'DECREASE_IN_VALUE_CANCELLATION' | 'DETACHMENT' | 'DETACHMENT_CANCELLATION' | 'DISCLOSURE' | 'DISCLOSURE_CANCELLATION' | 'DIVIDEND_OPTION' | 'DIVIDEND_OPTION_CANCELLATION' | 'DIVIDEND_REINVESTMENT' | 'DIVIDEND_REINVESTMENT_CANCELLATION' | 'DRAWING' | 'DRAWING_CANCELLATION' | 'DUTCH_AUCTION' | 'DUTCH_AUCTION_CANCELLATION' | 'EXCHANGE' | 'EXCHANGE_CANCELLATION' | 'EXTERNAL_SEPA_DIRECT_DEBIT' | 'EXTERNAL_SEPA_DIRECT_DEBIT_CHARGE_BACK' | 'EXTRAORDINARY_OR_SPECIAL_GENERAL_MEETING' | 'EXTRAORDINARY_OR_SPECIAL_GENERAL_MEETING_CANCELLATION' | 'FEE_COLLECTION' | 'FEE_COLLECTION_CANCELLATION' | 'FINAL_MATURITY' | 'FINAL_MATURITY_CANCELLATION' | 'FULL_CALL' | 'FULL_CALL_CANCELLATION' | 'INCREASE_IN_VALUE' | 'INCREASE_IN_VALUE_CANCELLATION' | 'INFORMATION' | 'INFORMATION_CANCELLATION' | 'INSTALMENT_CALL' | 'INSTALMENT_CALL_CANCELLATION' | 'INTEREST_PAYMENT' | 'INTEREST_PAYMENT_CANCELLATION' | 'INTERMEDIATE_SECURITIES_DISTRIBUTION' | 'INTERMEDIATE_SECURITIES_DISTRIBUTION_CANCELLATION' | 'INTERNAL_CASH_TRANSFER' | 'INTERNAL_CASH_TRANSFER_CANCELLATION' | 'ISA_TRANSFER' | 'LIQUIDATION_PAYMENT' | 'LIQUIDATION_PAYMENT_CANCELLATION' | 'MATURITY_EXTENSION' | 'MATURITY_EXTENSION_CANCELLATION' | 'MERGER' | 'MERGER_CANCELLATION' | 'NON_OFFICIAL_OFFER' | 'NON_OFFICIAL_OFFER_CANCELLATION' | 'NON_US_TEFRA_D_CERTIFICATION' | 'NON_US_TEFRA_D_CERTIFICATION_CANCELLATION' | 'ODD_LOT_SALE' | 'ODD_LOT_SALE_CANCELLATION' | 'ORDER_EXECUTION' | 'ORDER_EXECUTION_CANCELLATION' | 'ORDINARY_GENERAL_MEETING' | 'ORDINARY_GENERAL_MEETING_CANCELLATION' | 'OTHER_EVENT' | 'OTHER_EVENT_CANCELLATION' | 'PARI_PASSU' | 'PARI_PASSU_CANCELLATION' | 'PARTIAL_DEFEASANCE' | 'PARTIAL_DEFEASANCE_CANCELLATION' | 'PARTIAL_REDEMPTION_WITH_POOL_FACTOR_REDUCTION' | 'PARTIAL_REDEMPTION_WITH_POOL_FACTOR_REDUCTION_CANCELLATION' | 'PARTIAL_REDEMPTION_WITHOUT_POOL_FACTOR_REDUCTION' | 'PARTIAL_REDEMPTION_WITHOUT_POOL_FACTOR_REDUCTION_CANCELLATION' | 'PAY_IN_KIND' | 'PAY_IN_KIND_CANCELLATION' | 'PEAK_FRACTION_COMPENSATION' | 'PEAK_ORDER_ADJUSTMENT' | 'PLACE_OF_INCORPORATION' | 'PLACE_OF_INCORPORATION_CANCELLATION' | 'PRIORITY_ISSUE' | 'PRIORITY_ISSUE_CANCELLATION' | 'PUT_REDEMPTION' | 'PUT_REDEMPTION_CANCELLATION' | 'REDENOMINATION' | 'REDENOMINATION_CANCELLATION' | 'REMARKETING_AGREEMENT' | 'REMARKETING_AGREEMENT_CANCELLATION' | 'REPURCHASE_OFFER' | 'REPURCHASE_OFFER_CANCELLATION' | 'REVERSE_STOCK_SPLIT' | 'REVERSE_STOCK_SPLIT_CANCELLATION' | 'RIGHTS_ISSUE' | 'RIGHTS_ISSUE_CANCELLATION' | 'SCRIP_DIVIDEND' | 'SCRIP_DIVIDEND_CANCELLATION' | 'SEPA_DIRECT_DEBIT' | 'SEPA_DIRECT_DEBIT_CHARGE_BACK' | 'SHARES_PREMIUM_DIVIDEND' | 'SHARES_PREMIUM_DIVIDEND_CANCELLATION' | 'SMALLEST_NEGOTIABLE_UNIT' | 'SMALLEST_NEGOTIABLE_UNIT_CANCELLATION' | 'SPIN_OFF' | 'SPIN_OFF_CANCELLATION' | 'STOCK_DIVIDEND' | 'STOCK_DIVIDEND_CANCELLATION' | 'STOCK_SPLIT' | 'STOCK_SPLIT_CANCELLATION' | 'TAX_ON_NON_DISTRIBUTED_PROCEEDS' | 'TAX_ON_NON_DISTRIBUTED_PROCEEDS_CANCELLATION' | 'TAX_PAYMENT' | 'TAX_PREPAYMENT_DE' | 'TAX_RECLAIM' | 'TAX_RECLAIM_CANCELLATION' | 'TAX_REFUND' | 'TENDER' | 'TENDER_CANCELLATION' | 'TOPUP' | 'TOPUP_CANCELLATION' | 'TRADING_STATUS_ACTIVE' | 'TRADING_STATUS_ACTIVE_CANCELLATION' | 'TRADING_STATUS_DELISTED' | 'TRADING_STATUS_DELISTED_CANCELLATION' | 'TRADING_STATUS_SUSPENDED' | 'TRADING_STATUS_SUSPENDED_CANCELLATION' | 'TREASURY_PAYMENT' | 'VIRTUAL_CASH_CORRECTION' | 'VIRTUAL_CASH_CORRECTION_CANCELLATION' | 'VIRTUAL_CASH_DECREASE' | 'VIRTUAL_CASH_INCREASE' | 'WARRANT_EXERCISE' | 'WARRANT_EXERCISE_CANCELLATION' | 'WITHDRAWAL' | 'WITHDRAWAL_CANCELLATION' | 'WORTHLESS' | 'WORTHLESS_CANCELLATION' | 'WITHHOLDING_TAX_RELIEF_CERTIFICATION' | 'WITHHOLDING_TAX_RELIEF_CERTIFICATION_CANCELLATION', required: Transaction type * ACCUMULATION - Accumulation * ACCUMULATION_CANCELLATION - Accumulation cancellation * ANNUAL_GENERAL_MEETING - Annual general meeting * ANNUAL_GENERAL_MEETING_CANCELLATION - Annual general meeting cancellation * ATTACHMENT - Attachment * ATTACHMENT_CANCELLATION - Attachment cancellation * BALANCE_CORRECTION - Balance correction * BALANCE_CORRECTION_CANCELLATION - Balance correction cancellation * BANKRUPTCY - Bankruptcy * BANKRUPTCY_CANCELLATION - Bankruptcy cancellation * BOND_DEFAULT - Bond default * BOND_DEFAULT_CANCELLATION - Bond default cancellation * BOND_HOLDER_MEETING - Bond holder meeting * BOND_HOLDER_MEETING_CANCELLATION - Bond holder meeting cancellation * BONUS_ISSUE - Bonus Issue/Capitalisation Issue * BONUS_ISSUE_CANCELLATION - Bonus Issue/Capitalisation Issue, Cancellation * CALL_ON_INTERMEDIATE_SECURITIES - Call on Intermediate Securities * CALL_ON_INTERMEDIATE_SECURITIES_CANCELLATION - Call on Intermediate Securities cancellation * CAPITAL_DISTRIBUTION - Capital distribution * CAPITAL_DISTRIBUTION_CANCELLATION - Capital distribution cancellation * CAPITAL_GAINS_DISTRIBUTION - Capital gains distribution * CAPITAL_GAINS_DISTRIBUTION_CANCELLATION - Capital gains distribution cancellation * CAPITALISATION - Capitalisation * CAPITALISATION_CANCELLATION - Capitalisation cancellation * CASH_DISTRIBUTION_FROM_NON_ELIGIBLE_SECURITIES_SALES - Cash distribution from non eligible securities sales * CASH_DISTRIBUTION_FROM_NON_ELIGIBLE_SECURITIES_SALES_CANCELLATION - Cash distribution from non eligible securities sales cancellation * CASH_DIVIDEND - Cash dividend * CASH_DIVIDEND_CANCELLATION - Cash dividend cancellation * CHANGE - Change * CHANGE_CANCELLATION - Change, Cancellation * CLASS_ACTION - Class action * CLASS_ACTION_CANCELLATION - Class action cancellation * COMPANY_OPTION - Company option * COMPANY_OPTION_CANCELLATION - Company option cancellation * CONSENT - Consent * CONSENT_CANCELLATION - Consent cancellation * CONVERSION - Conversion * CONVERSION_CANCELLATION - Conversion cancellation * COURT_MEETING - Court meeting * COURT_MEETING_CANCELLATION - Court meeting cancellation * CREDIT_EVENT - Credit event * CREDIT_EVENT_CANCELLATION - Credit event cancellation * CREDIT_FUNDING - Credit funding * CREDIT_FUNDING_CHARGE_BACK - Credit funding charge back * DD_REFUND_REJECT_FEE - Direct debit refund reject fee * DD_REFUND_REJECT_FEE_CANCELLATION - Direct debit refund reject fee cancellation * DECREASE_IN_VALUE - Decrease in Value * DECREASE_IN_VALUE_CANCELLATION - Decrease in Value, Cancellation * DETACHMENT - Detachment * DETACHMENT_CANCELLATION - Detachment cancellation * DISCLOSURE - Disclosure * DISCLOSURE_CANCELLATION - Disclosure cancellation * DIVIDEND_OPTION - Dividend Option * DIVIDEND_OPTION_CANCELLATION - Dividend Option, Cancellation * DIVIDEND_REINVESTMENT - Dividend Reinvestment * DIVIDEND_REINVESTMENT_CANCELLATION - Dividend Reinvestment, Cancellation * DRAWING - Drawing * DRAWING_CANCELLATION - Drawing cancellation * DUTCH_AUCTION - Dutch Auction * DUTCH_AUCTION_CANCELLATION - Dutch Auction, Cancellation * EXCHANGE - Exchange * EXCHANGE_CANCELLATION - Exchange cancellation * EXTERNAL_SEPA_DIRECT_DEBIT - External sepa direct debit * EXTERNAL_SEPA_DIRECT_DEBIT_CHARGE_BACK - External sepa direct debit charge back * EXTRAORDINARY_OR_SPECIAL_GENERAL_MEETING - Extraordinary or special general meeting * EXTRAORDINARY_OR_SPECIAL_GENERAL_MEETING_CANCELLATION - Extraordinary or special general meeting cancellation * FEE_COLLECTION - Fee collection * FEE_COLLECTION_CANCELLATION - Fee collection cancellation * FINAL_MATURITY - Final maturity * FINAL_MATURITY_CANCELLATION - Final maturity cancellation * FULL_CALL - Full call * FULL_CALL_CANCELLATION - Full call cancellation * INCREASE_IN_VALUE - Increase in Value * INCREASE_IN_VALUE_CANCELLATION - Increase in Value, Cancellation * INFORMATION - Information * INFORMATION_CANCELLATION - Information cancellation * INSTALMENT_CALL - Instalment call * INSTALMENT_CALL_CANCELLATION - Instalment call cancellation * INTEREST_PAYMENT - Interest payment * INTEREST_PAYMENT_CANCELLATION - Interest payment cancellation * INTERMEDIATE_SECURITIES_DISTRIBUTION - Intermediate Securities Distribution * INTERMEDIATE_SECURITIES_DISTRIBUTION_CANCELLATION - Intermediate Securities Distribution, Cancellation * INTERNAL_CASH_TRANSFER - Internal cash transfer * INTERNAL_CASH_TRANSFER_CANCELLATION - Internal cash transfer, Cancellation * ISA_TRANSFER - ISA transfer * LIQUIDATION_PAYMENT - Liquidation Dividend/Liquidation Payment * LIQUIDATION_PAYMENT_CANCELLATION - Liquidation Dividend/Liquidation Payment, Cancellation * MATURITY_EXTENSION - Maturity extension * MATURITY_EXTENSION_CANCELLATION - Maturity extension cancellation * MERGER - Merger * MERGER_CANCELLATION - Merger, Cancellation * NON_OFFICIAL_OFFER - Non-Official Offer * NON_OFFICIAL_OFFER_CANCELLATION - Non-Official Offer, Cancellation * NON_US_TEFRA_D_CERTIFICATION - Non us tefra d certification * NON_US_TEFRA_D_CERTIFICATION_CANCELLATION - Non us tefra d certification cancellation * ODD_LOT_SALE - Odd Lot Sale/Purchase * ODD_LOT_SALE_CANCELLATION - Odd Lot Sale/Purchase, Cancellation * ORDER_EXECUTION - Order execution * ORDER_EXECUTION_CANCELLATION - Order execution cancellation * ORDINARY_GENERAL_MEETING - Ordinary general meeting * ORDINARY_GENERAL_MEETING_CANCELLATION - Ordinary general meeting cancellation * OTHER_EVENT - Other Event * OTHER_EVENT_CANCELLATION - Other Event, Cancellation * PARI_PASSU - Pari passu * PARI_PASSU_CANCELLATION - Pari passu cancellation * PARTIAL_DEFEASANCE - Partial defeasance * PARTIAL_DEFEASANCE_CANCELLATION - Partial defeasance cancellation * PARTIAL_REDEMPTION_WITH_POOL_FACTOR_REDUCTION - Partial redemption with pool factor reduction * PARTIAL_REDEMPTION_WITH_POOL_FACTOR_REDUCTION_CANCELLATION - Partial redemption with pool factor reduction cancellation * PARTIAL_REDEMPTION_WITHOUT_POOL_FACTOR_REDUCTION - Partial redemption without pool factor reduction * PARTIAL_REDEMPTION_WITHOUT_POOL_FACTOR_REDUCTION_CANCELLATION - Partial redemption without pool factor reduction cancellation * PAY_IN_KIND - Pay in kind * PAY_IN_KIND_CANCELLATION - Pay in kind cancellation * PEAK_FRACTION_COMPENSATION - Peak fraction compensation * PEAK_ORDER_ADJUSTMENT - Peak order adjustment * PLACE_OF_INCORPORATION - Place of incorporation * PLACE_OF_INCORPORATION_CANCELLATION - Place of incorporation cancellation * PRIORITY_ISSUE - Priority Issue * PRIORITY_ISSUE_CANCELLATION - Priority Issue, Cancellation * PUT_REDEMPTION - Put redemption * PUT_REDEMPTION_CANCELLATION - Put redemption cancellation * REDENOMINATION - Redenomination * REDENOMINATION_CANCELLATION - Redenomination cancellation * REMARKETING_AGREEMENT - Remarketing agreement * REMARKETING_AGREEMENT_CANCELLATION - Remarketing agreement cancellation * REPURCHASE_OFFER - Repurchase Offer/Issuer Bid/Reverse Rights * REPURCHASE_OFFER_CANCELLATION - Repurchase Offer/Issuer Bid/Reverse Rights, Cancellation * REVERSE_STOCK_SPLIT - Reverse Stock Split/Change in Nominal Value * REVERSE_STOCK_SPLIT_CANCELLATION - Reverse Stock Split/Change in Nominal Value, Cancellation * RIGHTS_ISSUE - Rights Issue/Subscription Rights/Rights Offer * RIGHTS_ISSUE_CANCELLATION - Rights Issue/Subscription Rights/Rights Offer, Cancellation * SCRIP_DIVIDEND - Scrip dividend * SCRIP_DIVIDEND_CANCELLATION - Scrip dividend cancellation * SEPA_DIRECT_DEBIT - Sepa direct debit * SEPA_DIRECT_DEBIT_CHARGE_BACK - Sepa direct debit charge back * SHARES_PREMIUM_DIVIDEND - Shares Premium Dividend * SHARES_PREMIUM_DIVIDEND_CANCELLATION - Shares Premium Dividend, Cancellation * SMALLEST_NEGOTIABLE_UNIT - Smallest negotiable unit * SMALLEST_NEGOTIABLE_UNIT_CANCELLATION - Smallest negotiable unit cancellation * SPIN_OFF - Spin-Off * SPIN_OFF_CANCELLATION - Spin-Off, Cancellation * STOCK_DIVIDEND - Stock Dividend * STOCK_DIVIDEND_CANCELLATION - Stock Dividend, Cancellation * STOCK_SPLIT - Stock Split/Change in Nominal Value/Subdivision * STOCK_SPLIT_CANCELLATION - Stock Split/Change in Nominal Value/Subdivision, Cancellation * TAX_ON_NON_DISTRIBUTED_PROCEEDS - Tax on non distributed proceeds * TAX_ON_NON_DISTRIBUTED_PROCEEDS_CANCELLATION - Tax on non distributed proceeds cancellation * TAX_PAYMENT - Tax payment * TAX_PREPAYMENT_DE - German tax prepayment (Vorabpauschale) * TAX_RECLAIM - Tax reclaim * TAX_RECLAIM_CANCELLATION - Tax reclaim cancellation * TAX_REFUND - Tax refund * TENDER - Tender/Acquisition/Takeover/Purchase Offer * TENDER_CANCELLATION - Tender/Acquisition/Takeover/Purchase Offer, Cancellation * TOPUP - Cash top up * TOPUP_CANCELLATION - Top up cancellation * TRADING_STATUS_ACTIVE - Trading status active * TRADING_STATUS_ACTIVE_CANCELLATION - Trading status active cancellation * TRADING_STATUS_DELISTED - Trading status delisted * TRADING_STATUS_DELISTED_CANCELLATION - Trading status delisted cancellation * TRADING_STATUS_SUSPENDED - Trading status suspended * TRADING_STATUS_SUSPENDED_CANCELLATION - Trading status suspended cancellation * TREASURY_PAYMENT - Treasury payment * VIRTUAL_CASH_CORRECTION - Virtual cash correction * VIRTUAL_CASH_CORRECTION_CANCELLATION - Virtual cash correction cancellation * VIRTUAL_CASH_DECREASE - Virtual cash decreased * VIRTUAL_CASH_INCREASE - Virtual cash increased * WARRANT_EXERCISE - Warrant exercise * WARRANT_EXERCISE_CANCELLATION - Warrant exercise cancellation * WITHDRAWAL - Withdrawal * WITHDRAWAL_CANCELLATION - Withdrawal cancellation * WORTHLESS - Worthless * WORTHLESS_CANCELLATION - Worthless, Cancellation * WITHHOLDING_TAX_RELIEF_CERTIFICATION - Withholding tax relief certification * WITHHOLDING_TAX_RELIEF_CERTIFICATION_CANCELLATION - Withholding tax relief certification cancellation
    - `updated_at` string, date-time, required: Date and time when the resource was last updated. [RFC 3339-5](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6), [ISO8601 UTC](https://www.iso.org/iso-8601-date-and-time-format.html)
    - `value_date` string, date-time, required: Transaction value date and time. [RFC 3339-5](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6), [ISO8601 UTC](https://www.iso.org/iso-8601-date-and-time-format.html)

## Other responses

- `400`: Bad Request. The incoming request had a malformed parameter/object.
- `401`: Unauthorized. The caller has not been authenticated.
- `403`: Forbidden. The caller has been authenticated but is not allowed to take the requested action.
- `404`: Not Found. The requested resource could not be found.
- `405`: Method Not Allowed. The requested method is not allowed on the requested resource.
- `406`: Not Acceptable. The resource does not have a current representation that would be acceptable to the user agent. "Accept" header defined unsupported value.
- `429`: Too Many Requests. The caller has exceeded their quota for the time period and has been throttled.
- `500`: Internal Server Error. The service encountered an unexpected error.
- `503`: Service Unavailable. The service handling for this request cannot be reached at this time.
- `504`: Gateway Timeout. The service gateway has reached its internal timeout.

## Changes

- **2026-10-13** `d148910c1b92`: 2 warning
  - added the new `PENSION_DE_ALLOWANCE` enum value to the `data/items/references/items/type` response property for the response status `200`
  - added the new `PENSION_DE_ALLOWANCE_UPDATE` enum value to the `data/items/references/items/type` response property for the response status `200`
- **2026-10-09** `052750ba3a1e`: 1 warning
  - added the new `CHARGED_BY_CLIENT_NET` enum value to the `data/items/fees/items/charge_method` response property for the response status `200`
- **2026-09-07** `210928eb221a`: 3 warning, 1 info
  - added the new `EXTERNAL_DIRECT_DEBIT` enum value to the `data/items/references/items/type` response property for the response status `200`
  - added the new `EXTERNAL_SEPA_DIRECT_DEBIT` enum value to the `data/items/type` response property for the response status `200`
  - added the new `EXTERNAL_SEPA_DIRECT_DEBIT_CHARGE_BACK` enum value to the `data/items/type` response property for the response status `200`
  - added the optional property `data/items/fx` to the response with the `200` status

[Operation history](https://skmtc.dev/upvest/apis/upvest-investment-api/changes/transactions/cash/get.md)

---

[API](https://skmtc.dev/upvest/apis/upvest-investment-api.md) · [All operations](https://skmtc.dev/upvest/apis/upvest-investment-api/llms.txt) · [OpenAPI document](https://skmtc.dev/upvest/apis/upvest-investment-api/revisions/ca69534b631d?raw)