Skip to main content

Stage a last mile delivery order

POST /v2/fulfillment/lastmile/orders/{order_id}/staged

Marks the order as staged and ready for delivery, which triggers an event to dispatch an Instacart shopper to the store location. Send this request when the bags are in a staging area. An Instacart shopper will pick up the order from the staging area and deliver it.

Security#

NameInDescription
AuthorizationheaderThe Authorization header with the bearer token acquired during authentication.

Parameters#

NameInRequiredDescription
order_idpathโœ…The unique ID from the order to be staged.

Request#

FieldTypeRequiredDescription
items_countintegerThe number of items in the order.
bags_countintegerThe number of bags in the order.
items_weightnumberThe weight of the items in lbs.

Request Examples#

curl --request POST \  --url 'https://connect.instacart.com/v2/fulfillment/lastmile/orders/{order_id}/staged' \  --header 'Accept: application/json' \  --header 'Authorization: Bearer <token>' \  --header 'Content-Type: application/json' \  --data '{  "items_count": 1,  "bags_count": 1,  "items_weight": 1}'

Response#

FieldTypeRequiredDescription
idstringโœ…The ID of the order.
statusstringโœ…The current order status.
order_urlstringLink to view the order.
created_atstringThe time of order creation in ISO 8601 format.
cancellation_reasonstringThe reason the order was canceled.
localestringThe order's locale in POSIX format. Example: en_US.
fulfillment_detailsFulfillment_detailsThe order delivery details.

Fulfillment_details Object#

FieldTypeRequiredDescription
store_locationstringThe location code of the store where the order was fulfilled. The store_location is often the same as the location_code that was used to create the order. However, orders can be fulfilled from a different store location.
window_starts_atstringโœ…The start time of the delivery window in ISO 8601 format.
window_ends_atstringโœ…The end time of the delivery window in ISO 8601 format.
delivered_atstringThe time the order was delivered at in ISO 8601 format.
bag_countintegerThe number of bags in the order.

Response Examples#

{  "id": "12345676789012345678780",  "status": "created",  "order_url": "https://example.com/example-order",  "created_at": "2018-02-22T00:00:00Z",  "cancellation_reason": "",  "locale": "en_US",  "fulfillment_details": {    "window_starts_at": "2018-02-22T00:00:00Z",    "window_ends_at": "2018-02-22T00:00:00Z"  }}