---
title: "Retarget deposit order"
method: PUT
path: "/v0/deposit-orders/{id}/retarget"
tags: ["Deposit orders"]
---

# Retarget deposit order

`PUT /v0/deposit-orders/{id}/retarget`

## Request

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

**Move a funded deposit order to another share class of the same fund, before it is valued.**

- Use this when an investor funded a deposit for one share class and wants the shares issued in another one - a different currency class of the same fund, typically.
- The order must be `funded` and not yet selected for execution. Once the daily execution has picked it up, retargeting is refused.
- The target share class must belong to the same fund as the current one, must be available to you, and the investor's account must not have a frozen or closed line for it. A line the account does not hold yet is opened as part of the re-target.
- Returns the updated order, with its new `shareClassId`.

> **Distribute-with-Spiko's-license distributors** cannot re-target this order from their backend. The investor must do it directly from the browser with a short-lived [Investor JWT](/developers/distributor_api/technical_guides/investor_jwt), targeting the investor-scoped path **`PUT /v0/investor/deposit-orders/{id}/retarget`** (identical payload and response, but authenticated with the investor JWT as bearer token instead of your API credentials).

## Path parameters

- `id` string, uuid, required: a Universally Unique Identifier

## Request body

- object
  - `shareClassId` string, uuid, required: a Universally Unique Identifier

## Response `200`

Success

- 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
    - `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"
    - `createdAt` string, required
    - `settlement` object, nullable, 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"
      - `shares` string, required
      - `appliedNAV` object, required
        - `day` string, required: a day in ISO format "YYYY-MM-DD"
        - `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"
    - `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
    - `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"
    - `createdAt` string, required
    - `settlement` object, nullable, 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"
      - `shares` string, required
      - `appliedNAV` object, required
        - `day` string, required: a day in ISO format "YYYY-MM-DD"
        - `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"
    - `status` 'pending-collection', 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
    - `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"
    - `createdAt` string, required
    - `settlement` object, nullable, 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"
      - `shares` string, required
      - `appliedNAV` object, required
        - `day` string, required: a day in ISO format "YYYY-MM-DD"
        - `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"
    - `status` 'funded', required
    - `fundedAt` 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
    - `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"
    - `createdAt` string, required
    - `settlement` object, nullable, 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"
      - `shares` string, required
      - `appliedNAV` object, required
        - `day` string, required: a day in ISO format "YYYY-MM-DD"
        - `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"
    - `status` 'executed', required
    - `fundedAt` string, required
    - `executedAt` 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
    - `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"
    - `createdAt` string, required
    - `settlement` object, nullable, 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"
      - `shares` string, required
      - `appliedNAV` object, required
        - `day` string, required: a day in ISO format "YYYY-MM-DD"
        - `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"
    - `status` 'canceled', required
    - `canceledAt` string, required

## Other responses

- `400`: Application Error | 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)