---
title: "List the current investor's transactions"
method: GET
path: "/v1/invest/investor/transactions"
tags: ["Invest"]
---

# List the current investor's transactions

`GET /v1/invest/investor/transactions`

## Request

- Base URL: `https://api.prod.keyban.io`
- URL: `https://api.prod.keyban.io/v1/invest/investor/transactions`
- Auth: `bearer` (a scheme the document does not define)

List transactions where the current investor is either the buyer or the seller. Sorted by createdAt desc by default.

## Query parameters

- `filters` union[]
  - union
    - object
      - `operator` 'or' | 'and', required
      - `value` union[], required
        - union
          - object
            - `field` 'id', required
            - `operator` 'eq', required
            - `value` string, required
          - object
            - `field` 'createdAt', required
            - `operator` 'gt' | 'lt' | 'gte' | 'lte', required
            - `value` string, date-time, required
          - object
            - `field` 'updatedAt', required
            - `operator` 'gt' | 'lt' | 'gte' | 'lte', required
            - `value` string, date-time, required
          - object
            - `field` 'fund.id', required
            - `operator` 'eq', required
            - `value` string, uuid, required
          - object
            - `field` 'type', required
            - `operator` 'eq', required
            - `value` 'INITIAL_DISTRIBUTION' | 'BUY_BACK' | 'SECONDARY_MARKET', required
          - object
            - `field` 'status', required
            - `operator` 'eq', required
            - `value` 'PENDING' | 'VALIDATED' | 'REJECTED', required
    - object
      - `field` 'id', required
      - `operator` 'eq', required
      - `value` string, required
    - object
      - `field` 'createdAt', required
      - `operator` 'gt' | 'lt' | 'gte' | 'lte', required
      - `value` string, date-time, required
    - object
      - `field` 'updatedAt', required
      - `operator` 'gt' | 'lt' | 'gte' | 'lte', required
      - `value` string, date-time, required
    - object
      - `field` 'fund.id', required
      - `operator` 'eq', required
      - `value` string, uuid, required
    - object
      - `field` 'type', required
      - `operator` 'eq', required
      - `value` 'INITIAL_DISTRIBUTION' | 'BUY_BACK' | 'SECONDARY_MARKET', required
    - object
      - `field` 'status', required
      - `operator` 'eq', required
      - `value` 'PENDING' | 'VALIDATED' | 'REJECTED', required
- `sorters` object[]
  - `field` 'id' | 'createdAt' | 'updatedAt' | 'createdAt' | 'shares' | 'price', required
  - `order` 'asc' | 'desc', required
- `currentPage` integer
- `pageSize` integer

## Response `200`

List of transactions retrieved successfully.

- PaginatedInvestTransactionDto
  - `data` object[], required: Array of items for the current page
    - `id` string, uuid, required: Entity UUID
    - `createdAt` string, date-time, required: Creation date (ISO 8601)
    - `updatedAt` string, date-time, required: Last update date (ISO 8601)
    - `fund` string, uuid, required: The unique identifier of the investment fund
    - `seller` string, uuid, nullable: UUID of the InvestIdentity acting as the seller. Null when `type` is `INITIAL_DISTRIBUTION` (primary issuance: the fund itself emits shares, there is no selling counterparty).
    - `buyer` string, uuid, nullable: UUID of the InvestIdentity acting as the buyer. Null when `type` is `BUY_BACK` (the fund redeems shares from an investor; there is no buying counterparty).
    - `shares` integer, required: Number of whole shares exchanged in this transaction (minimum 1).
    - `price` number, required: Unit price per share in the fund currency at the time of the transaction. Multiply by `shares` to obtain the total settlement amount.
    - `currency` 'EUR' | 'USD', required: Currency of the transaction, inherited from the fund (ISO 4217 code, e.g. `EUR`, `USD`).
    - `type` 'INITIAL_DISTRIBUTION' | 'BUY_BACK' | 'SECONDARY_MARKET', required: Transaction type. `INITIAL_DISTRIBUTION`: primary issuance of shares from the fund to a KYC-verified investor — `seller` is null. `BUY_BACK`: fund redemption of shares held by an investor — `buyer` is null. `SECONDARY_MARKET`: peer-to-peer transfer of shares between two investors via a secondary-market offer.
    - `status` 'PENDING' | 'VALIDATED' | 'REJECTED', required: Lifecycle status of the transaction. `PENDING`: submitted and awaiting validation (KYC check, blockchain settlement). `VALIDATED`: confirmed on-chain; shares have been transferred. `REJECTED`: declined due to KYC failure, lockup period violation, or insufficient funds.
  - `total` integer, required: Total count of items matching the query

---

[API](https://skmtc.dev/keyban/apis/keyban-rest-apis.md) · [All operations](https://skmtc.dev/keyban/apis/keyban-rest-apis/llms.txt) · [OpenAPI document](https://skmtc.dev/keyban/apis/keyban-rest-apis/revisions/0bb79a1da961?raw)