GET /v2/transfer-orders/{transfer_order_id}

Retrieve transfer orderBeta

GET

/v2/transfer-orders/{transfer_order_id}

Retrieves a specific TransferOrder by ID.

Returns the complete order details including:

Basic information (status, dates, notes)
Line items with ordered and received quantities
Source and destination Locations
Tracking information (if available)

Permissions:INVENTORY_READ

Try in API Explorer

Link to section

Path parameters

Example code

Link to section

transfer_order_id

string

Required

The ID of the transfer order to retrieve

Link to section

Response fields

Link to section

transfer_order

The requested transfer order

Link to section

errors

Any errors that occurred during the request

curl https://connect.squareup.com/v2/transfer-orders/EXAMPLE_TRANSFER_ORDER_ID_123 \ -H 'Square-Version: 2025-10-16' \ -H 'Authorization: Bearer ACCESS_TOKEN' \ -H 'Content-Type: application/json'

{ "transfer_order": { "id": "EXAMPLE_TRANSFER_ORDER_ID_123", "source_location_id": "EXAMPLE_SOURCE_LOCATION_ID_123", "destination_location_id": "EXAMPLE_DEST_LOCATION_ID_456", "status": "STARTED", "created_at": "2025-01-15T10:30:00Z", "updated_at": "2025-01-15T10:35:00Z", "expected_at": "2025-11-09T05:00:00Z", "notes": "Example transfer order for inventory redistribution between locations", "tracking_number": "TRACK123456789", "created_by_team_member_id": "EXAMPLE_TEAM_MEMBER_ID_789", "line_items": [ { "uid": "1", "item_variation_id": "EXAMPLE_ITEM_VARIATION_ID_001", "quantity_ordered": "5", "quantity_pending": "5", "quantity_received": "0", "quantity_damaged": "0", "quantity_canceled": "0" }, { "uid": "2", "item_variation_id": "EXAMPLE_ITEM_VARIATION_ID_002", "quantity_ordered": "3", "quantity_pending": "3", "quantity_received": "0", "quantity_damaged": "0", "quantity_canceled": "0" } ], "version": 1753117449752 } }

Retrieve transfer orderBeta

Path parameters

Response fields

Error descriptions