---
title: "Receive Transfer Order"
method: PUT
path: "/transfer-orders/{id}/receive"
tags: ["transfer_order"]
---

# Receive Transfer Order

`PUT /transfer-orders/{id}/receive`

## Request

- Base URL: `https://app.zenventory.com/rest`
- URL: `https://app.zenventory.com/rest/transfer-orders/{id}/receive`
- Auth: none declared

Receive shipping items from the origin warehouse into the destination warehouse.

## Path parameters

- `id` integer, required

## Request body

- object
  - `locationId` integer, required: Id of the location in the destination warehouse the inventory will be placed in.
  - `locationName` integer, required: Name of the location in the destination warehouse the inventory will be placed in. Ignored if locationId is provided.
  - `receiveLocationId` integer: Id of the staging location in the destination warehouse the inventory will first be placed in. Only used if staged delivery is enabled in the settings.
  - `receiveLocationName` integer: Name of the staging location in the destination warehouse the inventory will first be placed in. Only used if staged delivery is enabled in the settings. Ignored if receiveLocationId is provided.
  - `items` object[]: Items being received in.
    - `id` integer, required: Id of the transfer order line item.
    - `quantity` integer, required: Number of items being received. Cannot exceed the amount shipped.
    - `serialNumbers` unknown[]: List of serial numbers being received. Required if item is serialized and must match quantity.
      - unknown

## Response `200`

Success

- TransferOrder
  - `id` integer
  - `originWarehouse` WarehouseCompact
    - `id` integer
    - `name` string
  - `destinationWarehouse` WarehouseCompact
    - `id` integer
    - `name` string
  - `draft` boolean
  - `completed` boolean
  - `requiredBy` string, date-time
  - `createdDate` string, date-time
  - `preparedBy` UserCompact
    - `id` integer
    - `name` string
  - `preparedDate` string, date-time
  - `shipVia` string
  - `deleted` boolean
  - `deletedBy` UserCompact
    - `id` integer
    - `name` string
  - `deletedDate` string, date-time
  - `cancelled` boolean
  - `cancelledBy` UserCompact
    - `id` integer
    - `name` string
  - `cancelledDate` string, date-time
  - `cancelledReason` string
  - `notes` string
  - `tags` Tag[]
    - `id` integer
    - `tag` string
    - `note` string
  - `items` TransferOrderItem[]
    - `id` integer
    - `itemId` integer
    - `sku` string
    - `description` string
    - `quantity` integer
    - `uom` string
    - `allocatedQuantity` integer
    - `pickedQuantity` integer
    - `deliveredQuantity` integer

---

[API](https://skmtc.dev/zenventory/apis/zenventory-rest-api.md) · [All operations](https://skmtc.dev/zenventory/apis/zenventory-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zenventory/apis/zenventory-rest-api/revisions/b40aa340773b?raw)