Skip to main content
POST
Execute Booking

Execute Booking

This endpoint creates a real booking and sends a voucher email within 30 seconds. 99% success rate with live inventory sync.

Use This Endpoint When

User confirms selection

  • “Book this one”
  • “Reserve for tomorrow”
  • “I want the spa package”

After recommendation

  • User selected from /recommend results
  • User chose from /inventory listings

Request

string
required
Activity ID from /recommend or /inventory response
string
required
Email address for voucher delivery
string
required
Guest name for the voucher
string
required
ISO 8601 date format (e.g., 2025-12-15)
number
required
Number of adults (1-20)
number
default:"0"
Number of children
string
Recommended: Pass the log_id from /recommend response for conversion tracking and feedback loop
string
Any special requests or notes
string
Optional URL to receive booking status callbacks

Response

boolean
Whether the booking was created successfully
object

Examples

Basic Booking

Family Booking with Children

With Webhook Callback

Response Example

Booking Flow

Ground Truth Feedback Loop

Why pass context_log_id?When a user visits the venue and scans their QR code, we connect:
  1. The original recommendation context
  2. Which activity was booked
  3. Whether they actually visited
This creates a feedback loop that improves future recommendations for similar user profiles.

Webhook Events

If you provide a webhook_url, you’ll receive callbacks for: Webhook payload example:

Error Responses

Error Response Example

Best Practices

This enables the Ground Truth feedback loop, improving recommendations over time.
Use webhooks to update your UI in real-time when voucher is delivered or QR is scanned.
Check that booking_date is not in the past and is within the activity’s operating days.
Bookings are real and charged. Always confirm details with the user before calling this endpoint.

Next Steps

Check Inventory

View real-time availability before booking

Webhooks

Set up webhook callbacks for booking events