All notable changes to this project will be documented in this file. The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

¶ Sep 26, 2025

Added

• Improved visibility for batched orders: dropoff_sequence_number and short_batch_id added to the Get Delivery Response and Delivery Status Webhook

Updated

• Best practice recommendations for Delivery Window guide

¶ Sep 22, 2025

Added

• Added store and organization level role_assignments in the Invite New User to Organization allowing granular control over user permissions within their organization structure.
• Added FAQ: Store level access and role assignments
• Added documentation for CPP Create Quote endpoint.

¶ Sep 2, 2025

Added

• Added FAQ: How do stores contact the courier?

Fixed

• Improved clarity for contract_type in Create Direct Organizations endpoint.

¶ Jul 19, 2025

Added

• Added optional fields first_name and last_name to point_of_contact in Create Direct Organizations. This improves the user experience for organizations using decentralized billing.
• Added shopping_completed delivery status in Delivery Status Webhook for CPP orders.

Fixed

• manifest_items.replacement_types values now accurately reflect api response in the CPP API
• Corrected user_fees_summary data structure in Create Delivery
• Corrected user_fees_summary.amount_in_cents to user_fees_summary.amount
• Removed duplicate courier name in Delivery Status Webhook Sample
• Removed obsolete \"\" from Address Best Practices
• Removed return.status and return.status_timestamp from Get Delivery Response to correctly reflect payload response.

¶ May 29, 2025

Added

• Added item_customizations to Create Delivery endpoint, allowing merchants to specify custom modifications for individual manifest items.

Changed

• Modified default geocoding behavior in Geocoding guide. Dropoff addresses are now geocoded by Uber by default. Merchants can contact Uber Support to use their own lat/lng coordinates instead.

¶ Apr 17, 2025

Added

• Support for new query parameters in the List Deliveries endpoint:
  • external_store_id: Filter deliveries by external store identifier.
  • start_dt: Filter deliveries starting from a specific date/time (RFC 3339 format).
  • end_dt: Filter deliveries up to a specific date/time (RFC 3339 format).
• Added optional object user_fees_summary in Create Delivery request to specify individual fees and discounts and allow Uber support to issue partial refunds on the merchant’s behalf.
• Improved support for decentralized self-serve onboarding. This can be activated by setting contract type to CONTRACT_TYPE_PARENT in the Create Direct Organization endpoint.

¶ Feb 13, 2025

Added

• Added new Guide Geocoding
• The Get Delivery endpoint now returns the courier’s vehicle_license_plate.
• Added unmarked_location_description in webhook payloads.

Changed

• Added more clarification for dropoff_eta in Create Delivery response.
• Added more clarification in the Delivery Window guide.

¶ Oct 22, 2024

Added

• Added new API Courier Pick and Pack
• Added new Guide JS SDK
• Added new Shopping Progress Webhook for Courier Pick and Pack API
• Added new field public_phone_info in Get Delivery, Delivery Status Webhook and Courier Update Webhook
• Added ROLE_SUPPORT in Organizations API for new support user type in Direct Dashboard.

¶ Sept 1, 2024

Added

• Added new field contract_type to Create Organization API
• Added note for not allowed characters in Create Organization API
• Added new field return_notes in Create Delivery

¶ July 1, 2024

Added

• Added retry logic to Webhook Overview
• Added new field no_sobriety_check to dropoff_verification in Create Delivery
• Added new field type on dropoff_verification and return_verification in Create Delivery

¶ March 18, 2024

Added

• Added Public Postman Workspace. Uber’s Direct APIs are available at https://www.postman.com/uber/workspace/uber-direct/overview.

¶ Nov 30, 2023

Added

• Added code samples for all Direct API endpoints
• Added more description for batch_id in Delivery Status Webhook and Courier Update Webhook
• Added more description for Authenticating Webhooks
• Added more description for What are the address best practices?

Fixed

• Fixed 500 error message in Direct API

¶ Oct 24, 2023

Changed

• Added more clarification on x-uber-signature in the Authenticating Webhooks

Fixed

• Fixed incorrect country_iso2 payload value in Organizations API

Added

• Added more descriptions for address in Create Delivery
• Added vat_percentage in manifest_items

¶ Oct 18, 2023

Fixed

• Add CUSTOMER_CANCEL into webhook secondary reason

¶ Oct 16, 2023

Fixed

• Dedupe default duration update to 60mins
• Remove courier lat/long and vehicle information in delivered Webhook and add more descriptions

Added

• Added more descriptions about manifest_reference in Create Delivery and Update Delivery

¶ Oct 05, 2023

Fixed

• Replace “DaaS API” with “Direct API” throughout the entire document.

¶ Oct 02, 2023

Added

• Add Support and FAQ section

¶ Sep 26, 2023

Fixed

• Refine create account process in Get Started

¶ Sep 21, 2023

Removed

• Removed locale from Create Direct Organizations

¶ Sep 14, 2023

Fixed

• Fix List Delivery Endpoint URL

¶ Sep 12, 2023

Added

• Added more response code in DaaS API

¶ Sep 1, 2023

Added

• Clarify Pickup/Business Names in Create Delivery

Fixed

• Fix barcode description in Proof of Delivery
• Fix structured address malformed in Create Delivery
• Fix lng typo in Create Delivery

¶ Aug 31, 2023

Added

• Added more information on updating barcode verification in Proof of Delivery

¶ Aug 24, 2023

Added

• Added more error code to Create Delivery

¶ Aug 21, 2023

Added

• Added Options to create organization endpoint

¶ Aug 18, 2023

Fixed

• Fixed the scope description in authentication request table

¶ Aug 17, 2023

Added

• Add the “signature_requirement” within the “return_verification” of the Create Delivery request

Fixed

• Fixed the descriptions of Picture Requirement
• Fixed the URL of List Delivery Endpoint

Removed

• Remove verification section under CreateDelivery 200 response

¶ Aug 15, 2023

Fixed

• Mark requires_id as deprecated
• Fixed all descriptions around “cents” in all DaaS API

¶ Aug 10, 2023

Added

• Enhance the clarity of the external_store_id description

Removed

• Removed sublocality_level_1 from whole document

¶ Aug 09, 2023

Added

• Added pincode verification page in Pincode

¶ Jul 27, 2023

Fixed

• Fixed Authentication page in Authentication

Added

• Added refund information in Get Delivery

¶ Jul 26, 2023

Fixed

• Fixed scope in Organization API
• Fixed urls in Organization API

Added

• Added courier info in Get Delivery, Cancel Delivery and Update Delivery

¶ Jul 4, 2023

Fixed

• Fixed phone_number description in Courier Info on Delivery Status Notification Webhook

¶ Jun 09, 2023

Added

• Added note to dimensions on Manifest Items in Create Delivery

¶ May 24, 2023

Fixed

• Fixed Getting started page in Getting Started

¶ May 19, 2023

Added

• Added discard to Undeliverable Action options

¶ May 16, 2023

Fixed

• Fixed Cancellation Reasons on Delivery Status Notification and Courier Update Notification

Added

• Added definition for external_id on Create Delivery

¶ May 09, 2023

Removed

• Removed value ongoing from allowed values on status list in Get Delivery

Fixed

• Fixed dropoff_phone_number and pickup_phone_number description in Create Delivery and Create Qoute to include format specification

¶ May 04, 2023

Removed

• Removed dropoff_identifier in Create Delivery, Cancel Delivery, Update Delivery, List Delivery, Delivery Status Notification and Courier Update Notification

Added

• Added outcome and timestamp to scan_result in Verification Barcode Scan Result
• Added description for primary and secondary cancellation_reason on Delivery Status Notification and Courier Update Notification

¶ May 03, 2023

Added

• Added description about the usage of delivery_id and UUID in POD Retrieval

¶ May 02, 2023

Fixed

• Fixed description in Manifest
• Fixed description in Manifest Item

¶ May 01, 2023

Fixed

• Fixed notes for deliverable and undeliverable actions Request Parameters
• Fixed description in Deliverable Action
• Fixed description in Undeliverable Action

¶ Apr 28, 2023

Added

• Added verification description in Direct Get Delivery Status

Fixed

• Fixed all descriptions around “cents” in all DaaS API
• Fixed errors order in POD Retrieval

¶ Apr 14, 2023

Added

• Added the Create Organization API
• Added the Refund Notification Webhook to the DaaS API
• Added batch_id to Delivery Status Notification which will now be used instead of route_id for identifying batched orders

Fixed

• Fixed the object type for the size from object to string field in Create Delivery and Update Delivery
• Fixed missing descriptions for Address field in Create Organization API
• Fixed incorrect description for pickup_phone_number field in Create Delivery
• Standardized the manifest items reference body in Create Delivery
• Fixed the event field in Delivery Status Notification payload to only display kind and status
• Fixed status description in Create Delivery Response to always show pending by default

Changed

• Changed the HTTP status code for address_undeliverable_limited_couriers from 422 to 400 in Create Quote and Create Delivery
• Change the description for courier_imminent in Delivery Status Notification Webhooks, Courier Update Notification, and Get Delivery

Removed

• Removed the package field as a verification requirements as it was outdated
• Removed an outdated overview page and HTTP status code page
• Removed unused parameters in manifest_items in Create Delivery