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.

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.