Openings

To get the available reservation times for a restaurant, you can give this endpoint the Business ID along with a few parameters. This endpoint will return times around the requested timeslot and across several days to provide the end user with some options.

In general, the openings endpoint will return times across 4 days - the day before, current day and 2 days after the requested date.

Currently, Yelp Reservations API does not support reservations which require a credit card. So, if "credit_card_required": true is returned, you should NOT proceed to the Holds endpoint. If you do, the Holds endpoint will return a null hold_id.

cURL example with OAuth authentication:

    curl -X GET "https://api.yelp.com/v3/bookings/victors-french-bistro-test-listing-san-francisco/openings?covers=2&date=2017-12-30&time=18%3A00" -H "Authorization: Bearer {ACCESS_TOKEN}"

Example 200 response:

{
  "reservation_times": [
    {
      "date": "2017-09-22",
      "times": [
    {
      "credit_card_required": true,
      "time": "14:45",
      "url":
  "https://www.devc.yelpreservations.com/r/dorsia/reserve/2017-09-22/1445/3/"
    },
    {
      "credit_card_required": true,
      "time": "15:00",
      "url":
  "https://www.devc.yelpreservations.com/r/dorsia/reserve/2017-09-22/1500/3/"
    },
    {
      "credit_card_required": true,
      "time": "15:15",
      "url":
  "https://www.devc.yelpreservations.com/r/dorsia/reserve/2017-09-22/1515/3/"
    },
      ]
    },
    {
      "date": "2017-09-23",
      "times": [
  {
      "credit_card_required": true,
      "time": "14:45",
      "url":
  "https://www.devc.yelpreservations.com/r/dorsia/reserve/2017-09-23/1445/3/"
    },
    {
      "credit_card_required": true,
      "time": "15:00",
      "url":
  "https://www.devc.yelpreservations.com/r/dorsia/reserve/2017-09-23/1500/3/"
    },
    {
      "credit_card_required": true,
      "time": "15:15",
      "url":
  "https://www.devc.yelpreservations.com/r/dorsia/reserve/2017-09-23/1515/3/"
    },
      ]
    },
  ]
  "covers_range": {
    "min_party_size": 1,
    "max_party_size": 7
  }
}
Language
Authorization
Header
Click Try It! to start a request and see the response here!