Skip to main content

Get a last mile delivery order

GET /v2/fulfillment/lastmile/orders/{order_id}

Deprecated

This endpoint has been replaced by the same Get an order endpoint that is used for delivery and pickup orders. This change reflects our commitment to making our API more intuitive to use when implementing multiple fulfillment workflows in your ecommerce site. The deprecated endpoint is still supported for existing implementations. For new implementations, use the shared endpoint.

Retrieves order details by order ID. Order details include the status, creation time, and time slot. For orders that have been fulfilled, the response includes the store location, how many bags were in the order, and when the customer received their order.

Security#

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

Parameters#

NameInTypeRequiredDescription
order_idpathstringโœ…The ID of the order.

Examples#

curl --request GET \  --url 'https://connect.instacart.com/v2/fulfillment/lastmile/orders/{order_id}' \  --header 'Accept: application/json' \  --header 'Authorization: Bearer <token>'

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"  }}