---
title: "Transfers into containers"
method: POST
path: "/transfers"
tags: ["containers"]
---

# Transfers into containers

`POST /transfers`

## Request

- Base URL: `https://{tenant_name}.benchling.com/api/v2`
- URL: `https://{tenant_name}.benchling.com/api/v2/transfers`
- Auth: HTTP bearer

Transfers a volume of an entity or container into a destination container. Limit of 5000 transfers per request. Concentration of all contents in the destination container will be automatically updated based on the previous volume & concentrations of the contents in that container, the concentration of the contents being transferred in, the volume of the contents being transferred in, and the final volume of the container. If no concentration is specified, the concentration will not be tracked.

## Request body

- MultipleContainersTransfersList
  - `transfers` MultipleContainersTransfer[], required
    - `restrictedSamplePartyIds` string[]: IDs of users or teams to be set as restricted sample parties for the destination container. If not specified, restricted sample parties from the source container, if present, will be added to those of the destination container. This only applies to stand-alone containers.
    - `restrictionStatus` 'RESTRICTED' | 'UNRESTRICTED' | 'NOT_APPLICABLE'
    - `sampleOwnerIds` string[]: IDs of users or teams to be set as sample owners for the destination container. If not specified, restricted sample parties from the source container, if present, will be added to those of the destination container. This only applies to stand-alone containers.
    - `sourceBatchId` string: ID of the batch that will be transferred in. Must specify one of sourceEntityId, sourceBatchId, or sourceContainerId.
    - `sourceContainerId` string: ID of the container that will be transferred in. Must specify one of sourceEntityId, sourceBatchId, or sourceContainerId.
    - `sourceEntityId` string: ID of the entity that will be transferred in. Must specify one of sourceEntityId, sourceBatchId, or sourceContainerId.
    - `transferQuantity` ContainerQuantity: Quantity of a container, well, or transfer. Supports mass, volume, and other quantities.
      - `units` 'L' | 'mL' | 'uL' | 'nL' | 'pL' | 'gal (US)' | 'qt (US)' | 'pt (US)' | 'kg' | 'g' | 'mg' | 'ug' | 'ng' | 'pg' | 'lb' | 'oz' | 'mol' | 'mmol' | 'umol' | 'nmol' | 'pmol' | 'cells' | '(x10^3) cells' | '(x10^4) cells' | '(x10^5) cells' | '(x10^6) cells' | '(x10^7) cells' | '(x10^8) cells' | '(x10^9) cells' | 'items' | 'units'
      - `value` number, double, nullable
    - `transferVolume` DeprecatedContainerVolumeForInput: Desired volume for a container, well, or transfer. "volume" type keys are deprecated in API requests; use the more permissive "quantity" type key instead.
      - `units` 'pL' | 'nL' | 'uL' | 'mL' | 'L'
      - `value` number, double, nullable
    - `destinationContainerId` string, required: ID of container that will be transferred into.
    - `finalQuantity` ContainerQuantity: Quantity of a container, well, or transfer. Supports mass, volume, and other quantities.
      - `units` 'L' | 'mL' | 'uL' | 'nL' | 'pL' | 'gal (US)' | 'qt (US)' | 'pt (US)' | 'kg' | 'g' | 'mg' | 'ug' | 'ng' | 'pg' | 'lb' | 'oz' | 'mol' | 'mmol' | 'umol' | 'nmol' | 'pmol' | 'cells' | '(x10^3) cells' | '(x10^4) cells' | '(x10^5) cells' | '(x10^6) cells' | '(x10^7) cells' | '(x10^8) cells' | '(x10^9) cells' | 'items' | 'units'
      - `value` number, double, nullable
    - `finalVolume` DeprecatedContainerVolumeForInput: Desired volume for a container, well, or transfer. "volume" type keys are deprecated in API requests; use the more permissive "quantity" type key instead.
      - `units` 'pL' | 'nL' | 'uL' | 'mL' | 'L'
      - `value` number, double, nullable
    - `sourceConcentration` Measurement
      - `units` string, nullable, required: Can only be null if value is also null
      - `value` number, double, nullable, required: Can only be null if units is also null

## Response `202`

This endpoint launches a [long-running task](https://docs.benchling.com/docs/api/v2/benchling-api/tasks/get-task) and returns the Task ID of the launched task.
The task response contains the full list of destination [containers](https://docs.benchling.com/docs/api/v2/benchling-api/containers/get-container).

- AsyncTaskLink
  - `taskId` string

## Other responses

- `400`: Bad Request

---

[API](https://skmtc.dev/benchling/apis/benchling-api-2.md) - [All operations](https://skmtc.dev/benchling/apis/benchling-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/benchling/apis/benchling-api-2/revisions/01d2fa8523cd?raw)