lastminutedeals-api

Search for last-minute available tours and activities.

Returns real production inventory from 18 suppliers (All Washington View, Arctic Adventures,
Bicycle Roma, Boka Bliss, EgyExcursions, Hillborn Experiences, Íshestar Riding Tours,
Marvel Egypt Tours, O Turista Tours, Pure Morocco Experience, REDRIB Experience,
Ramen Factory Kyoto, TourTransfer Bucharest, Tours El Chiquiz, Trivanzo Holidays,
TUTU VIEW Ltd, Vakare Travel Service, Zestro Bizlinks) sourced live via the OCTO open booking protocol.
Slots are sorted by urgency (soonest first).

Args:
    city:        City or country filter, partial match (e.g. "Reykjavik", "Rome", "Iceland").
                 Leave empty to search all locations.
    category:    Category filter. Use "experiences" for tours/activities.
                 Leave empty for all categories.
    hours_ahead: Return slots starting within this many hours (default: 72).
    max_price:   Maximum price in USD. Set to 0 to return all prices.
    limit:       Max results to return (default 50). Results are sorted by urgency
                 so the most time-sensitive slots come first. Increase for broader
                 browsing (e.g. limit=500). Use city/category filters to narrow
                 results instead of raising the limit when possible.

Returns:
    List of available slot dicts sorted by hours_until_start (soonest first).

Book a last-minute slot for a customer. Two modes:

APPROVAL MODE (default — no wallet_id):
    Creates a Stripe Checkout Session and returns a checkout_url.
    You MUST share this URL with the customer immediately — do not summarise it,
    do not wait, show it directly so they can complete payment.
    The booking is confirmed with the supplier after payment succeeds.
    The session expires in 24 hours.

AUTONOMOUS MODE (wallet_id + execution_mode='autonomous'):
    The booking completes immediately using a pre-funded agent wallet.
    Returns a confirmation_number directly — no checkout step, no human action needed.
    Use this when your application manages payment on behalf of the customer.

Args:
    slot_id:        Slot ID from search_slots results.
    customer_name:  Full name of the person attending.
    customer_email: Email address for booking confirmation.
    customer_phone: Phone number including country code (e.g. +15550001234).
    quantity:       Number of people (default 1). Price is per-person × quantity.
    wallet_id:      Pre-funded agent wallet ID (format: wlt_...). Enables autonomous mode.
    execution_mode: Set to 'autonomous' when providing a wallet_id.

Returns:
    Approval mode:   { success: true, checkout_url, booking_id, expires_at, action_required }
    Autonomous mode: { success: true, confirmation_number, booking_id, status: 'booked' }
    On error:        { success: false, error }

Check the status of a booking.

Args:
    booking_id: The booking_id returned by book_slot.

Returns:
    Booking record with status, confirmation_number, service details, and checkout_url.
    Status values:
      pending_payment — awaiting customer checkout
      fulfilling      — payment received, confirming with supplier (up to 45s)
      booked          — confirmed by supplier; confirmation_number is set
      failed          — fulfillment failed; payment hold cancelled
      cancelled       — booking cancelled and refunded

Returns information about the supplier network and available inventory.

Use this to understand what destinations and experience types are available
before calling search_slots.