Overview
About DoorDash Marketplace for Retail
The DoorDash Marketplace Retail APIs enable approved retailers and integration partners to manage product catalog, inventory, store hours, promotions, and order fulfillment data programmatically. These APIs support a wide range of retail categories, including grocery, convenience, pharmacy, beauty, pet, alcohol, and apparel.
Before you begin development, determine whether your organization will integrate as a merchant or a third-party integration partner, as this distinction defines your access model and certification path.
- Merchants are retailers that build and maintain their own software integrations with DoorDash. They manage product data, orders, and fulfillment directly through their systems. Typical examples include national or regional grocery, pharmacy, and specialty retail chains.
- Third-Party Integration Partners include POS, middleware, and other approved technology platforms that enable multiple merchants to connect to DoorDash using shared software such as order management, fulfillment orchestration, or inventory systems. These partners are evaluated and certified based on performance, reliability, and adherence to DoorDash Retail standards.
Important: DoorDash Marketplace is not open-access. Access is by approval only, and partners must submit a request to join our backlog. New partners will be notified via email if they are qualified. This controlled onboarding process ensures that only production-ready integrations go live on our Retail platform.
API Overview
DoorDash Marketplace Retail APIs are designed to keep your store catalog, pricing, and availability synchronized with the DoorDash platform in real time. They allow merchants and certified partners to manage all core aspects of the retail experience programmatically — from product setup to order fulfillment.
Each functional area has its own API domain. Together, they form a complete lifecycle for retail data management:
Catalog Management
The catalog represents your master list of products at the business level. You define every sellable item, including names, descriptions, images, nutritional data, and universal identifiers (UPC, SKU, GTIN).
Inventory and Pricing Management
Inventory defines each store's real-time stock, price, and local configuration of catalog items. DoorDash retrieves inventory data through pull jobs or accepts on-demand updates via POST/PATCH requests to store-item endpoints.
Store Hours
Store hours APIs define the operational attributes of each store's business hours and special hours.
Promotion Management
Promotion APIs allow retailers to create and manage discounts and special offers available through DoorDash.
Order Management and Fulfillment
The order APIs enable integration of DoorDash's order lifecycle into your internal systems — from creation and acceptance through to handoff or delivery completion.
Integration Workflow Summary
- Create your catalog → Define your business-level products.
- Assign to stores → Use store-item endpoints to localize pricing and inventory.
- Set store configuration → Define hours.
- Keep data in sync → Maintain inventory accuracy and update prices regularly.
- Receive and fulfill orders → Manage the full lifecycle through the Orders API.
- Monitor health and jobs → Use event logs to track synchronization and job results.
API Endpoint Call Patterns:
| API Endpoint | Batch Size | Rate Limit |
|---|---|---|
| Inventory/Pricing API POST | 10k | 5-10 QPS |
| Inventory/Pricing API PATCH | 10k | 5-10 QPS |
| Inventory PULL | 10k | 5-10 QPS |
| Catalog Management API POST | 1k | 5-10 QPS |
| Catalog Management API PATCH | 1k | 5-10 QPS |
| PROMOTION Management API POST | 1k | 5-10 QPS |
| STORE HOURS API PATCH | N/A | 5-10 QPS |