---
title: "Get swap orders"
method: GET
path: "/v0/swap-orders/"
tags: ["Swap orders"]
---

# Get swap orders

`GET /v0/swap-orders/`

## Request

- Base URL: `https://distributor-api.spiko.io`
- URL: `https://distributor-api.spiko.io/v0/swap-orders/`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/spiko/apis/spiko-distributor-api/docs/v0/swap-orders/get.ts> (a function with typed inputs; its response is checked against the schema)

**Retrieve a paginated list of the swap orders made by an investor.**

> ⚠️ **For displaying an account's activity, prefer the [account transaction history endpoint](#tag/Account-transactions/operation/accountTransactions.getAccountTransactions).** It returns deposits, withdrawals, transfers and yield accruals as a single time-ordered stream, with cursor pagination, so you don't need to call multiple per-order-type endpoints and reconcile their results.

- Orders are sorted by creation date (newest first).
- When `shareClassId` is specified, only swap orders with that share class on either side are returned.
- Pagination parameters (`page` & `limit`) are optional and default to `page = 1` and `limit = 50`.

## Query parameters

- `investorId` string, uuid, required: a Universally Unique Identifier
- `shareClassId` string, uuid: a Universally Unique Identifier
- `page` string: defaults to "1" if not provided
- `limit` string: defaults to "50" if not provided

## Response `200`

Success

- union[]
  - union
    - object
      - `id` string, uuid, required: a Universally Unique Identifier
      - `investorId` string, uuid, required: a Universally Unique Identifier
      - `accountId` string, uuid, required: a Universally Unique Identifier
      - `fromShareClassId` string, uuid, required: a Universally Unique Identifier
      - `toShareClassId` string, uuid, required: a Universally Unique Identifier
      - `quantity` union, required
        - object
          - `mode` 'amount', required
          - `amount` NonNegativeAmount, required
            - `value` string, required: a string representation of a non-negative decimal number e.g. "10000", "0.00" or "3420.92"
            - `currency` 'EUR' | 'USD' | 'GBP' | 'CHF' | 'JPY' | 'SGD' | 'SEK' | 'NOK' | 'DKK' | 'PLN' | 'HUF' | 'CZK', required: a currency code among "EUR", "USD", "GBP", "CHF", "JPY", "SGD", "SEK", "NOK", "DKK", "PLN", "HUF", "CZK"
        - object
          - `mode` 'shares', required
          - `shares` string, required
        - object
          - `mode` 'total', required
      - `createdAt` string, required
      - `status` 'created', required
    - object
      - `id` string, uuid, required: a Universally Unique Identifier
      - `investorId` string, uuid, required: a Universally Unique Identifier
      - `accountId` string, uuid, required: a Universally Unique Identifier
      - `fromShareClassId` string, uuid, required: a Universally Unique Identifier
      - `toShareClassId` string, uuid, required: a Universally Unique Identifier
      - `quantity` union, required
        - object
          - `mode` 'amount', required
          - `amount` NonNegativeAmount, required
            - `value` string, required: a string representation of a non-negative decimal number e.g. "10000", "0.00" or "3420.92"
            - `currency` 'EUR' | 'USD' | 'GBP' | 'CHF' | 'JPY' | 'SGD' | 'SEK' | 'NOK' | 'DKK' | 'PLN' | 'HUF' | 'CZK', required: a currency code among "EUR", "USD", "GBP", "CHF", "JPY", "SGD", "SEK", "NOK", "DKK", "PLN", "HUF", "CZK"
        - object
          - `mode` 'shares', required
          - `shares` string, required
        - object
          - `mode` 'total', required
      - `createdAt` string, required
      - `status` 'executed', required
      - `executedAt` string, required
      - `settlement` object, required
        - `source` object, required
          - `shareClassId` string, uuid, required: a Universally Unique Identifier
          - `amount` NonNegativeAmount, required
            - `value` string, required: a string representation of a non-negative decimal number e.g. "10000", "0.00" or "3420.92"
            - `currency` 'EUR' | 'USD' | 'GBP' | 'CHF' | 'JPY' | 'SGD' | 'SEK' | 'NOK' | 'DKK' | 'PLN' | 'HUF' | 'CZK', required: a currency code among "EUR", "USD", "GBP", "CHF", "JPY", "SGD", "SEK", "NOK", "DKK", "PLN", "HUF", "CZK"
          - `sharesAmount` string, required
          - `appliedNAV` object, required
            - `day` string, required: a day in ISO format "YYYY-MM-DD"
            - `amount` NonNegativeAmount, required
              - …
        - `target` object, required
          - `shareClassId` string, uuid, required: a Universally Unique Identifier
          - `amount` NonNegativeAmount, required
            - `value` string, required: a string representation of a non-negative decimal number e.g. "10000", "0.00" or "3420.92"
            - `currency` 'EUR' | 'USD' | 'GBP' | 'CHF' | 'JPY' | 'SGD' | 'SEK' | 'NOK' | 'DKK' | 'PLN' | 'HUF' | 'CZK', required: a currency code among "EUR", "USD", "GBP", "CHF", "JPY", "SGD", "SEK", "NOK", "DKK", "PLN", "HUF", "CZK"
          - `sharesAmount` string, required
          - `appliedNAV` object, required
            - `day` string, required: a day in ISO format "YYYY-MM-DD"
            - `amount` NonNegativeAmount, required
              - …
        - `exchangeRate` object, nullable, required
          - `fundId` string, uuid, required: a Universally Unique Identifier
          - `day` string, required: a day in ISO format "YYYY-MM-DD"
          - `baseCurrency` 'EUR' | 'USD' | 'GBP' | 'CHF' | 'JPY' | 'SGD' | 'SEK' | 'NOK' | 'DKK' | 'PLN' | 'HUF' | 'CZK', required: a currency code among "EUR", "USD", "GBP", "CHF", "JPY", "SGD", "SEK", "NOK", "DKK", "PLN", "HUF", "CZK"
          - `quoteCurrency` 'EUR' | 'USD' | 'GBP' | 'CHF' | 'JPY' | 'SGD' | 'SEK' | 'NOK' | 'DKK' | 'PLN' | 'HUF' | 'CZK', required: a currency code among "EUR", "USD", "GBP", "CHF", "JPY", "SGD", "SEK", "NOK", "DKK", "PLN", "HUF", "CZK"
          - `fxRate` string, required
    - object
      - `id` string, uuid, required: a Universally Unique Identifier
      - `investorId` string, uuid, required: a Universally Unique Identifier
      - `accountId` string, uuid, required: a Universally Unique Identifier
      - `fromShareClassId` string, uuid, required: a Universally Unique Identifier
      - `toShareClassId` string, uuid, required: a Universally Unique Identifier
      - `quantity` union, required
        - object
          - `mode` 'amount', required
          - `amount` NonNegativeAmount, required
            - `value` string, required: a string representation of a non-negative decimal number e.g. "10000", "0.00" or "3420.92"
            - `currency` 'EUR' | 'USD' | 'GBP' | 'CHF' | 'JPY' | 'SGD' | 'SEK' | 'NOK' | 'DKK' | 'PLN' | 'HUF' | 'CZK', required: a currency code among "EUR", "USD", "GBP", "CHF", "JPY", "SGD", "SEK", "NOK", "DKK", "PLN", "HUF", "CZK"
        - object
          - `mode` 'shares', required
          - `shares` string, required
        - object
          - `mode` 'total', required
      - `createdAt` string, required
      - `status` 'canceled', required
      - `canceledAt` string, required
      - `canceledBy` 'admin' | 'distributor' | 'investor' | 'system', required

## Other responses

- `400`: The request did not match the expected schema
- `401`: Authentication failed. Two bodies are possible: the schema below when the API rejects the credentials, and `{ "error": { "code", "status", "request", "message" } }` when the API gateway rejects them first. Only the former carries a `_tag`.
- `403`: Forbidden
- `404`: NotFound
- `503`: The investor is undergoing a scheduled upgrade, access is temporarily paused to ensure data safety.

---

[API](https://skmtc.dev/spiko/apis/spiko-distributor-api.md) - [All operations](https://skmtc.dev/spiko/apis/spiko-distributor-api/llms.txt) - [OpenAPI document](https://skmtc.dev/spiko/apis/spiko-distributor-api/revisions/ad85137fd00b?raw)