# LocationsForMove <p> The LocationsForMove resource represents the locations that a fulfillment order can potentially move to. </p> ## Resource Properties ### LocationsForMove * locations_for_move: <p>A list of locations that a fulfillment order can potentially move to.</p> <ul> <li><strong>location</strong>: The location being considered as the fulfillment order's new assigned location.</li> <li><strong>movable</strong>: Whether the fulfillment order can be moved to the location.</li> <li><strong>message</strong>: A human-readable string with the reason why the fulfillment order, or some of its line items, can't be moved to the location.</li> </ul> * Type: x-string * Example: [{"location"=>{"id"=>5, "name"=>"123 Main St"}, "movable"=>false, "message"=>"Shirt - Medium can't be changed because it isn't stocked at this location."}, {"location"=>{"id"=>3, "name"=>"Alpha Location"}, "movable"=>true, "message"=>nil}, {"location"=>{"id"=>1, "name"=>"Bravo Location"}, "movable"=>false, "message"=>"Current location."}, {"location"=>{"id"=>2, "name"=>"Charlie Location"}, "movable"=>false, "message"=>"No items are stocked at this location."}, {"location"=>{"id"=>4, "name"=>"Delta Location"}, "movable"=>false, "message"=>"2 items can't be changed because they aren't stocked at this location."}] ## Retrieves a list of locations that a fulfillment order can potentially move to. Retrieves a list of locations that a fulfillment order can potentially move to. The resulting list is sorted alphabetically in ascending order by location name. ### Endpoint /admin/api/#{api_version}/fulfillment_orders/{fulfillment_order_id}/locations_for_move.json (GET) ### Parameters * api_version (required): * fulfillment_order_id (required): * fulfillment_order_id: The ID of the fulfillment order. ### Responses #### 200 Retrieves a list of locations that a fulfillment order can potentially move to. Examples: ##### Retrieve a list of locations that a fulfillment order can potentially move to. Request: ``` GET /admin/api/unstable/fulfillment_orders/1046000777/locations_for_move.json ``` Response: ``` HTTP/1.1 200 OK {"locations_for_move":[{"location":{"id":1072404542,"name":"Alpha Location"},"message":"Current location.","movable":false},{"location":{"id":1072404543,"name":"Bravo Location"},"message":"No items are stocked at this location.","movable":false}]} ```