Reservation Status

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/reservation/e33b40ef-f6b1-4f17-987c-d850892564b/status -H "authorization: Bearer {ACCESS_TOKEN}"

Example 200 response:

{ "active": true, "date": "2017-12-30", "time": "11:00:00", "covers": 3 }
Log in to see full request history
Path Params
string
required

The Reservation ID returned from the Reservations endpoint.

Query Params
integer
required
1 to 10

How many people are attending the reservation (min. value is 1; max value is 10).

Responses

Language
Credentials
Click Try It! to start a request and see the response here! Or choose an example:
application/json