---
title: "List secondary market offers"
method: GET
path: "/v1/invest/offers"
tags: ["Invest"]
---

# List secondary market offers

`GET /v1/invest/offers`

## Request

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

List all secondary market offers. Use fund.id filter to scope by fund.

## 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` 'identity.id', required
            - `operator` 'eq', required
            - `value` string, uuid, required
          - object
            - `field` 'type', required
            - `operator` 'eq', required
            - `value` 'BUY' | 'SELL', 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` 'identity.id', required
      - `operator` 'eq', required
      - `value` string, uuid, required
    - object
      - `field` 'type', required
      - `operator` 'eq', required
      - `value` 'BUY' | 'SELL', required
- `sorters` object[]
  - `field` 'id' | 'createdAt' | 'updatedAt' | 'price' | 'shares' | 'type' | 'expiresAt' | 'createdAt', required
  - `order` 'asc' | 'desc', required
- `currentPage` integer
- `pageSize` integer

## Response `200`

List of offers retrieved successfully.

- PaginatedInvestOfferDto
  - `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` object, required: The investment fund associated with the offer
      - `id` string, uuid, required
      - `name` string, required
    - `identity` object, required: The investor who created the offer
      - `id` string, uuid, required
      - `firstName` string, required
      - `lastName` string, required
      - `email` string, email, required
    - `type` 'BUY' | 'SELL', required: Direction of the offer on the secondary market. `BUY` indicates the investor is looking to purchase shares; `SELL` indicates they are offering shares for sale.
    - `shares` integer, required: Number of shares offered
    - `price` number, required: Unit price per share
    - `currency` 'EUR' | 'USD', required: Currency of the offer
    - `expiresAt` string, date-time, required: Expiration date of the offer
  - `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)