Skip to main content

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:

  • 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"
  • If open_hours.end_time is less than open_hours.start_time, this is interpreted as hours that extend into the next day. As an example, the below would translate to the store being open from 8:00 am to 1:40 am:

    "start_time": "08:00:00",
    "end_time": "02:00:00"
  • Hours for a single menu cannot have separate specified hour periods that overlap. As an example, these hours below would be considered invalid:

    {
    "day_index": "FRI",
    "start_time": "08:00:00",
    "end_time": "02:00:00"
    },
    {
    "day_index": "SAT",
    "start_time": "01: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.

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"
}
]