Get Held Package Booking
See Booking flow for the end-to-end lifecycle.
Endpoint: /bookings/create/package/{:sessionId}
METHOD: GET
Returns the current state of the held booking in a package session, exactly as the create, addon, excursion and supplemental-tour calls return it.
Use this to recover state when a response was lost — a timed-out request, a dropped connection, a retry — without abandoning the session and starting a new search. The call is read-only and can be made as often as needed; it neither changes the booking nor extends the session's lifetime.
Path Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| sessionId | string (UUID) | Yes | Session returned by /search/packages. Must be a package session and hold a booking. |
Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| user_key | string | Yes | Unique key associated with the calling agency. |
Example
Request
curl --location '{:apiBase}/bookings/create/package/{:sessionId}?user_key=abcdef' \
--header 'Authorization: Bearer XXXXXXXX'
Response
{
"packageCode": "CENTFOCWI27",
"packageStartDate": "2027-01-14T00:00:00",
"packageEndDate": "2027-01-21T00:00:00",
"packageDeparturePort": "OSL",
"packageArrivalPort": "BGO",
"addons": [],
"excursions": [
{
"code": "TROMSOTOUR",
"startDate": "2027-01-17T09:00:00",
"endDate": "2027-01-17T13:00:00",
"isMandatory": true,
"guests": [1]
}
],
"supplementalTours": [],
"priceBreakdown": {
"totalPrice": 2450.0,
"cabins": [
{
"code": "MX",
"guests": [
{
"guestId": 1,
"price": 2450.0
}
]
}
],
"addons": [],
"excursions": [],
"supplementalTours": []
},
"sessionId": "f91c02b2-f22a-42c9-80b7-e3ef591ef0e0",
"market": "US",
"currency": "USD",
"departureDate": "2027-01-15T20:00:00",
"arrivalDate": "2027-01-20T14:30:00",
"departurePort": "BGO",
"arrivalPort": "KKN",
"shipCode": "KH",
"embarkationNotification": null,
"guests": [
{
"id": 1,
"type": "ADULT"
}
],
"cabins": [
{
"id": 1,
"code": "MX",
"cabinType": "Outside",
"cabinNumber": "530",
"guests": [
1
]
}
]
}
Fields
The response body is identical in shape to Create Package Booking — see its Fields table for the full field reference.
Errors
See Error model for response-body shapes across status codes.
| Status | Cause |
|---|---|
| 400 | user_key query parameter is missing. |
| 404 | The session does not exist or has expired. |
| 409 | The session is not a package session, or no held booking has been created in it yet. |