LocationsForMove

Version 2020-01

The LocationsForMove resource represents the locations that a fulfillment order can potentially move to.

What you can do with LocationsForMove

The Shopify API lets you do the following with the LocationsForMove resource. More detailed versions of these general actions may be available:

LocationsForMove properties

locations_for_move
"locations_for_move": [
  {
    "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": null
  },
  {
    "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."
  }
]

A list of locations that a fulfillment order can potentially move to.

  • location: The location being considered as the fulfillment order's new assigned location.
  • movable: Whether the fulfillment order can be moved to the location.
  • message: A human-readable string with the reason why the fulfillment order, or some of its line items, can't be moved to the location.

Endpoints

GET /admin/api/2020-01/fulfillment_orders/{fulfillment_order_id}/locations_for_move.json
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.
fulfillment_order_id

The ID of the fulfillment order.

Retrieve a list of locations that a fulfillment order can potentially move to.

GET /admin/api/2020-04/fulfillment_orders/1025578643/locations_for_move.json
View Response
HTTP/1.1 200 OK
{
  "locations_for_move": [
    {
      "location": {
        "id": 1059367778,
        "name": "Alpha Location"
      },
      "message": "Current location.",
      "movable": false
    },
    {
      "location": {
        "id": 1059367779,
        "name": "Bravo Location"
      },
      "message": "No items are stocked at this location.",
      "movable": false
    }
  ]
}
Version 2020-04 (Latest)

The LocationsForMove resource represents the locations that a fulfillment order can potentially move to.

What you can do with LocationsForMove

The Shopify API lets you do the following with the LocationsForMove resource. More detailed versions of these general actions may be available:

LocationsForMove properties

locations_for_move
"locations_for_move": [
  {
    "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": null
  },
  {
    "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."
  }
]

A list of locations that a fulfillment order can potentially move to.

  • location: The location being considered as the fulfillment order's new assigned location.
  • movable: Whether the fulfillment order can be moved to the location.
  • message: A human-readable string with the reason why the fulfillment order, or some of its line items, can't be moved to the location.

Endpoints

GET /admin/api/2020-04/fulfillment_orders/{fulfillment_order_id}/locations_for_move.json
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.
fulfillment_order_id

The ID of the fulfillment order.

Retrieve a list of locations that a fulfillment order can potentially move to.

GET /admin/api/2020-04/fulfillment_orders/1025578643/locations_for_move.json
View Response
HTTP/1.1 200 OK
{
  "locations_for_move": [
    {
      "location": {
        "id": 1059367778,
        "name": "Alpha Location"
      },
      "message": "Current location.",
      "movable": false
    },
    {
      "location": {
        "id": 1059367779,
        "name": "Bravo Location"
      },
      "message": "No items are stocked at this location.",
      "movable": false
    }
  ]
}
Version 2020-07 (Release candidate)

The LocationsForMove resource represents the locations that a fulfillment order can potentially move to.

What you can do with LocationsForMove

The Shopify API lets you do the following with the LocationsForMove resource. More detailed versions of these general actions may be available:

LocationsForMove properties

locations_for_move
"locations_for_move": [
  {
    "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": null
  },
  {
    "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."
  }
]

A list of locations that a fulfillment order can potentially move to.

  • location: The location being considered as the fulfillment order's new assigned location.
  • movable: Whether the fulfillment order can be moved to the location.
  • message: A human-readable string with the reason why the fulfillment order, or some of its line items, can't be moved to the location.

Endpoints

GET /admin/api/2020-07/fulfillment_orders/{fulfillment_order_id}/locations_for_move.json
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.
fulfillment_order_id

The ID of the fulfillment order.

Retrieve a list of locations that a fulfillment order can potentially move to.

GET /admin/api/2020-04/fulfillment_orders/1025578643/locations_for_move.json
View Response
HTTP/1.1 200 OK
{
  "locations_for_move": [
    {
      "location": {
        "id": 1059367778,
        "name": "Alpha Location"
      },
      "message": "Current location.",
      "movable": false
    },
    {
      "location": {
        "id": 1059367779,
        "name": "Bravo Location"
      },
      "message": "No items are stocked at this location.",
      "movable": false
    }
  ]
}