Overview
Store Management API​
Overview​
The Store Management API is designed for DoorDash partners to manage the hours of operation for individual stores. It allows partners to update store availability for ordering.
Endpoint URL: https://openapi.doordash.com/marketplace/api/v2/stores/{store_location_id}
Getting Started​
Request​
HTTP Method:
- PATCH: Update individual store hours
Headers:
- Refer to the JWT authentication documentation for authentication details.
Payload Example: Link to Example Payload
Response​
Success Response:
- The response to a successful request will be a mirror of the payload provided in the request.
Fail Response Details:
- These are the same as previous endpoints.
Verification​
- Navigate to the store's Merchant Portal page and check the Store Availability section to verify changes are reflected.
FAQ​
What timezone should my ‘start_time’ and ‘end_time’ be?
- The hours should be set based on the timezone of the store.
How can I send hours if my store is open overnight?
- For specific information on how to configure the store hour fields, please refer to our Hours Configuration Reference.
How can I send hours if my store is open 24/7?
- For specific information on how to configure the store hour fields, please refer to our Hours Configuration Reference.
What causes a store hours update request to fail?
- DoorDash will fail the job if store hours fall into any of the following categories:
- Overlapping Hours across multiple days.
- Start Time = End Time and times are not 00:00.
- Store Open Hours are less than 30 minutes.
- DoorDash will fail the job if store hours fall into any of the following categories:
How can I send hours if my store is closed?
- If a store is closed on a particular day (like a holiday), use Store Special Hours and set
closed = true
. - If a store is always closed on a particular day of the week, use Store Open Hours and set
start_time = 00:00
andend_time = 00:00
for thatday_index
or omit theday_index
entirely. - If a store is temporarily closed on all days, DoorDash Store Availability webhooks should be used to deactivate the store. Additional information on our Store Availability Webhooks can be found here.
- If a store is closed on a particular day (like a holiday), use Store Special Hours and set
Why is my store on DoorDash closing earlier than the hours sent?
- This is a platform-wide logic where a buffer is applied to all stores on the DoorDash site. This allows for food prep time, time for Dasher arrival, etc., before the store actually closes.
Can I set hours for a specific item?
- Yes, there is the capability to control hourly availability at an Item Level, rather than a store level. This information will be sent via our Inventory/Pricing API. Store Hours will remain the default availability if Item Hours are not defined. More details can be found here.