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

Store Management API Payload​

Example JSON Payload​

Store Open Hours​

Considerations when setting hours:​

Store Special Hours​