• Example searches: “transaction”, “CreateOrder”, “/v2/locations”, “inventory”, “delete customer”

You are viewing an old version of the API
Retrieve inventory transfer BETA

GET /v2/inventory/transfers/{transfer_id}

Returns the InventoryTransfer object with the provided transfer_id.

Permissions
INVENTORY_READ
 Try in API Explorer

Path Parameters

Example code
Name Description
transfer_id
string
Required

ID of the InventoryTransfer to retrieve.

Response Fields
Name Description
errors
Error [ ]

Any errors that occurred during the request.
transfer
InventoryTransfer

The requested InventoryTransfer.

Examples

You are viewing an old version of the API
GET /v2/inventory/transfers/{transfer_id}
cURL
  • cURL
  • Ruby
  • Python
  • C#
  • Java
  • PHP
  • Node.js 
curl https://connect.squareup.com/v2/inventory/transfers/UDMOEO78BG6GYWA2XDRYX3KB \
  -H 'Square-Version: 2023-01-19' \
  -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"
  }
}