Retrieve inventory transferBeta

GET

/v2/inventory/transfers/{transfer_id}

Returns the InventoryTransfer object with the provided transfer_id.

Permissions:INVENTORY_READ

Try in API Explorer

Link to section

Path parameters

Example code

Link to section

transfer_id

string

Required

ID of the InventoryTransfer to retrieve.

Link to section

Response fields

Link to section

errors

Any errors that occurred during the request.

Link to section

transfer

The requested InventoryTransfer.

Link to section

Examples

GET /v2/inventory/transfers/{transfer_id}

curl https://connect.squareup.com/v2/inventory/transfers/UDMOEO78BG6GYWA2XDRYX3KB \
  -H 'Square-Version: 2024-10-17' \
  -H 'Authorization: Bearer ACCESS_TOKEN' \
  -H 'Content-Type: application/json'

Response JSON

{
  "errors": [],
  "transfer": {
    "id": "UDMOEO78BG6GYWA2XDRYX3KB",
    "catalog_object_id": "W62UWFY35CWMYGVWK6TWJDNI",
    "catalog_object_type": "ITEM_VARIATION",
    "created_at": "2016-11-17T13:02:15.142Z",
    "team_member_id": "LRK57NSQ5X7PUD05",
    "from_location_id": "C6W5YS5QM06F5",
    "to_location_id": "59TNP9SA8VGDA",
    "occurred_at": "2016-11-16T25:44:22.837Z",
    "quantity": "7",
    "reference_id": "4a366069-4096-47a2-99a5-0084ac879509",
    "source": {
      "product": "SQUARE_POS",
      "application_id": "416ff29c-86c4-4feb-b58c-9705f21f3ea0",
      "name": "Square Point of Sale 4.37"
    },
    "state": "IN_STOCK"
  }
}