Booking

arrival_window
Type: ArrivalWindow
Properties: 6
arrival_window_ref
Type: "origin" or "destination"enum

Delivery reference for the arrival window
contacts
Type: array of Contact

Notification contacts for the booking, each scoped to one or more route stops.

Properties: 7
created_at
Type: stringFormat: date-time

the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z
crew
Type: Crewnullable

Information about the crew assigned to the booking

Properties: 6
customer
Type: Customernullable

Optional customer information for organization bookings.

Properties: 3
customer_notifications_enabled
Type: boolean

Whether Lugg sends automated notifications to the booking user, customer, and contacts. Set only during booking creation; defaults to true. Webhooks and operational notifications are unaffected.
description
Type: string | null

Description of the trip
destination
Type: Location
Properties: 6
dispatch
Type: Dispatchnullable

Current (or most recent) dispatch progress with per-stop routing, present whenever a dispatch exists — including completed bookings. Null before any dispatch. Unlike the legacy dispatch_state, this is not gated on booking state; prefer it over dispatch_state.

Properties: 4
dispatch_state
Type: stringenum

Legacy booking-level dispatch tracking state, gated to the dispatched booking state (reverts to origin_pending once the booking completes). For multi-stop bookings, stop_* states indicate progress at an intermediate stop. Prefer the dispatch object (and its normalized dispatch.state) for accurate, per-stop progress.
values
- origin_pending
  
  Waiting to dispatch to origin
- origin_driving
  
  Luggers driving to origin
- origin_at
  
  Luggers arrived at origin
- origin_done
  
  Origin pickup completed
- stop_pending
  
  Waiting to dispatch to an intermediate stop
- stop_driving
  
  Luggers driving to an intermediate stop
- stop_at
  
  Luggers arrived at an intermediate stop
- stop_done
  
  Intermediate stop completed
- destination_pending
  
  Waiting to dispatch to destination
- destination_driving
  
  Luggers driving to destination
- destination_at
  
  Luggers arrived at destination
- destination_done
  
  Delivery completed at destination
fare
Type: Farenullable

Final charged fare; populated after fulfillment, otherwise null

Properties: 8
hid
Type: string

Booking confirmation code
id
Type: stringFormat: uuid
metadata
Type: object | null

Custom metadata associated with the booking
order_number
Type: string | null

Order number or reference identifier for the booking
origin
Type: Location
Properties: 6
photo_urls
Type: array of stringFormat: uri

URLs of photos associated with the trip
product
Type: ProductEnumenum

Product type for the service
values
- lite
  
  Single lugger in a pickup truck
- pickup
  
  Two luggers in a pickup truck
- van
  
  Two luggers in a cargo van
- xl
  
  Two luggers in a sprinter van
- box
  
  Two luggers in a box truck
quote
Type: BookingQuotenullable

Pricing information for the booking

Properties: 12
route
Type: array of RouteStop

All stops in order (origin through destination)

Properties: 7
share_url
Type: stringFormat: uri

Shareable tracking URL for the booking
state
Type: BookingStateEnumenum

Current state of the booking
values
- created
  
  Booking has been created but not yet dispatched
- dispatched
  
  Booking has been assigned to luggers
- cancelled
  
  Booking was cancelled
- completed
  
  Booking has been successfully completed
tip
Type: integer
min:
0

Booking-level tip in integer cents (USD). Set only during booking creation; 0 means no tip. Positive values must be at least 100 cents. Included in the final fare.
updated_at
Type: stringFormat: date-time

the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z