Reference
Store Management API Payload
Example JSON Payload
Example Payload
{
"open_hours": [
{
"day_index": "MON",
"start_time": "07:00",
"end_time": "15:00"
},
{
"day_index": "TUE",
"start_time": "07:00",
"end_time": "15:00"
},
{
"day_index": "WED",
"start_time": "07:00",
"end_time": "15:00"
},
{
"day_index": "THU",
"start_time": "07:00",
"end_time": "15:00"
},
{
"day_index": "FRI",
"start_time": "07:00",
"end_time": "15:00"
}
],
"special_hours": [
{
"date": "2023-11-24",
"closed": false,
"start_time": "12:00:00",
"end_time": "23:59:59"
}
]
}
Store Open Hours
open_hours.start_time
: Local start time for when orders can successfully be placed.open_hours.end_time
: Local end time for when orders can successfully be placed.open_hours.day_index
: Day of the week for specified hours.
Considerations when setting hours:
Sending a blank open hours section as seen below will clear all existing hours resulting in the store being CLOSED on the Marketplace until new hours are added:
"open_hours": []
DoorDash deducts 20 minutes from
open_hours.end_time
to determine the true ordering hours for our Marketplace. This allows Dashers ample time to pick up the order before the restaurant closes.To display hours as ‘All Day’ on Marketplace, set hours to the following:
"start_time": "00:00:00",
"end_time": "23:59:59"Open Hours are date-specific. If
open_hours.end_time
is less thanopen_hours.start_time
, this will cause the request to fail. As an example, to set the store being open from 8:00 am to 1:40 am:{
"day_index": "FRI",
"start_time": "08:00:00",
"end_time": "23:59:59"
},
{
"day_index": "SAT",
"start_time": "00:00:00",
"end_time": "01:40:00"
}Hours for a single menu cannot have separate specified hour periods that overlap within the same day. As an example, these hours below would be considered invalid:
{
"day_index": "FRI",
"start_time": "08:00:00",
"end_time": "12:00:00"
},
{
"day_index": "FRI",
"start_time": "10:00:00",
"end_time": "22:00:00"
}
Store Special Hours
Store Special Hours can be used to specify operating hours for a distinct date that differ from your typical hours. You may use special hours to either close, shorten, or extend operating hours.
special_hours.start_time
: Local start time for when orders can successfully be placed.special_hours.end_time
: Local end time for when orders can successfully be placed.special_hours.date
: Discrete date of when special hours will be enforced.special_hours.closed
: Boolean indicating whether the store is closed or not on this date.
Considerations when setting special hours:
Include all required Store Special Hours periods in each Store Management payload as they are rewritten with every request. I.e. If you omit or send a blank special_hours section, all previously added Special Hours will be removed, or if you omit specific Special Hours periods that were previously sent, they will be removed.
Because Store Special Hours are date-specific, if you wish to specify interday special hours, separate dates must be used:
"special_hours": [
{
"date": "2022-11-24",
"closed": false,
"start_time": "12:00:00",
"end_time": "23:59:59"
},
{
"date": "2022-11-25",
"closed": false,
"start_time": "00:00:00",
"end_time": "00:30:00"
}
]