Get Wizard Session

Fetch the persisted wizard session payload by ID.

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

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

200 OK

{
  "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.