---
title: "Submit a bulk deposit (preview)"
method: POST
path: "/v0/sandbox/bulk-deposits"
tags: ["Sandbox"]
---

# Submit a bulk deposit (preview)

`POST /v0/sandbox/bulk-deposits`

## Request

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

Splits one wire across the accounts of your investors in a share class: every line is validated, then one deposit order is created per line and the wire instructions to quote are returned. Every rejected line is reported at once. Preview available in the sandbox environment only; its contract may still change.

## Request body

- object
  - `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"
  - `lines` object[], required: The deposit of each investor, at most 1000 lines.
    - `investorId` string, uuid, required: a Universally Unique Identifier
    - `accountId` string, uuid: 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"

## Response `200`

Success

- object
  - `paymentEntryId` string, uuid, required: a Universally Unique Identifier
  - `wireInstructions` object, required
    - `reference` string, required
    - `iban` string, required: a valid IBAN (International Bank Account Number)
    - `bic` string, required: A valid BIC (Bank Identifier Code)
    - `intermediaryBic` string, nullable, required: A valid BIC (Bank Identifier Code)
    - `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"
  - `lines` object[], required
    - `depositOrderId` 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"

## Other responses

- `400`: Bad Request | 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
- `422`: Some lines of the bulk deposit cannot be accepted
- `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)