How to book a place
booking_linkRead-onlyIdempotent
A booking page for one place with the party size, date and time ALREADY FILLED IN. This does NOT make a reservation and Num does not hold a table — the traveller completes it on the venue's own platform (OpenTable, Resy, Tock, SevenRooms, Square and others). The response always carries booked: false and mode: "deeplink". You MUST NOT render this as a confirmation, and you MUST NOT tell a traveller a table is held. If the venue has no booking platform the response says so and returns the phone number instead — offer that rather than implying it cannot be visited.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | No | YYYY-MM-DD. | |
| time | No | HH:MM, 24-hour, local to the venue. | |
| party | No | Number of covers, 1–20. | |
| place_id | Yes | From search_places or open_places. |