Table of Contents

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.