Changelog - Post-checkout

The changelog summarizes the updates and enhancements made to the Instacart Connect Post-checkout API. The most recent changes are listed first. All changes are non-breaking changes.

November 3, 2025

• Restricted the availability of chat messages on the Order Status page to 24 hours, starting from when the order is delivered or cancelled. For more information, see Chat on the Order Status page.
• Added the is_expired field to the metadata object in the get chat messages response.

September 12, 2025

• Added the ability to remove shopper data.

September 8, 2025

• Added the Get started topic.

March 28, 2025

• Added the create or update pickup delegate operation.

March 13, 2025

• Updated the vehicle_type and color validation requirements in the create or update vehicle information request.

February 10, 2025

• Added an APIs Overview tile to the Instacart Connect APIs homepage.

January 24, 2025

• On certain pages that group topics by category, such as Concepts and Chat, the following changes have been made:
  • Fixed the Next button so that it now advances users to the next page.
  • Added cards that summarize and link to each of the category's topic pages.

July 15, 2024

• Added accepted values for the color field in the create or update vehicle information request.

November 29, 2023

• Added the locale field to the get an order response.

August 22, 2023

• Added the certified delivery confirmation page. For more information, see Certified delivery flow.

• Added the certified_delivery field to the response of the Get order handling information endpoint.

• Added the certified_delivery field to the response of the Get order items endpoint.

• Updated documentation to provide more detail about support for the integer data type. For more information, see Data formats.

August 14, 2023

• Updated documentation to provide more information about HTTP headers, including the following changes:
  • Added the Request headers section, and updated the Authentication section in the API Reference topic.
  • Added the Request headers topic.

January 4, 2023

• Updated the description for the body field of the Send a message to the shopper request to include a maximum length.

December 16, 2022

• Removed the image_url field from the Send a message to the shopper request.

June 14, 2022

• Renamed the Express membership to Instacart+. For more information, see Instacart+ membership.

April 8, 2022

• Connect now flags Express orders to help invoicing teams identify these orders. For more information, see Express memberships and How to verify Express membership and orders.
  • Added the is_express field to the get an order response.

March 30, 2022

• Updated all response schemas to indicate required response attributes.

February 14, 2022

• Added tutorials for retailers who want to design and host their own version of an order status page.

January 10, 2022

• Applied the following changes to the get order endpoint response:
  • Changed the fulfillment_type value delivery_only to last_mile_delivery.
  • Updated all workflow_state values to be in lowercase.
  • Removed window_starts_at, window_ends_at, and bags_count from the top-level Order object.
  • Added the fulfillment_details object as an attribute of Order. Fulfillment details contains the window_starts_at, window_ends_at, and bag_count values.

December 8, 2021

• Updated the table of supported workflow-states for the get order endpoint response.
• Updated the valid values for pickup_category for the get order endpoint response.

December 3, 2021

• Updated the response structure of a customer's vehicle information from an array to a single element.

November 8, 2021

• Added the following endpoints to support pickup orders:
  • Get the customer's vehicle information
  • Create or update vehicle information
  • Get pickup order instructions
  • Record the customer's arrival at the store
• Updated the Get order endpoint to add the pickup_category parameter.

November 4, 2021

• Added shopper-customer chat to the Order Status page.
• Added the following endpoints to support chat:
  • Get the messages associated with the order
  • Send a message to the shopper
  • Mark messages as read
• Added a callback to notify when a customer message is ready to send.

August 20, 2021

• Added the Post-checkout Guide, which introduces the Order Status page. The Order Status page consumes the Post-checkout endpoints.
• Added the Post-checkout API endpoints.