Skip to main content

​
Method

GET /v1/bookings/wizard/:id

​
Path Parameters

​
id
uuid
required
Wizard session ID.

​
Headers

​
Authorization
string
Bearer token (requires bookings:read).

​
Request Example

curl "https://api.voyantcloud.com/v1/bookings/wizard/wzd_01J0C6ZFWN6JQM4TP7A1ZA6X0M" \
  -H "Authorization: Bearer $VOYANT_API_KEY"

​
Response Fields

​
session
object
required
Full session record from bookings.wizard_sessions.
​
session.id
uuid
required
Session identifier.
​
session.workspace_id
uuid
Workspace that owns the session.
​
session.language
string
Language associated with the session.
​
session.currency
string
Currency used for pricing.
​
session.step
integer
Current wizard step.
​
session.version
integer
Client-side version counter.
​
session.data
object
Stored JSON payload (steps, passengers, pricing, etc.).
​
session.booking_id
uuid
Booking ID if the session has already been committed.
​
session.expires_at
timestamp
Session expiration timestamp.
​
session.locked_at
timestamp
Timestamp when commit processing locked the session.
​
session.consumed_at
timestamp
Timestamp when the session was consumed.

​
Response Example

{
  "session": {
    "id": "wzd_01J0C6ZFWN6JQM4TP7A1ZA6X0M",
    "workspace_id": "ws_01HZYPM2QF2R8X9SZQ0J9SYBCN",
    "user_id": null,
    "visitor_id": "anon_987",
    "language": "en",
    "currency": "EUR",
    "step": 3,
    "version": 1,
    "data": {
      "step_1": { "productId": "prod_123", "departureId": "dep_456" },
      "step_2": { "rooms": [{ "categoryKey": "double", "occupancy": 2, "quantity": 1 }] },
      "step_3": { "extensions": [{ "id": "ext_wifi", "quantity": 1 }] }
    },
    "booking_id": null,
    "expires_at": "2025-01-12T12:00:00Z",
    "locked_at": null,
    "consumed_at": null
  }
}
Sessions are stored per-region. The API automatically attempts a fallback region when the session is not found in the default database.