Booking Management API

Get Booking now returns information about SSRs present in NDC bookings in a cohesive form.
Get Booking now supports multiple hidden stops.
Create Booking and Get Booking now support the corporate loyalty program type (`CORPORATE_LOYALTY_ID`) for NDC bookings with American Airlines.
Get Booking and Modify Booking now allow displaying and changing room product code details.
An additional identity document type `FISCAL_ID`, which is applicable to NDC bookings, is now supported in Create Booking and Get Booking.
Create Booking and Get Booking now support creation and display of name reference code.
Create Booking and Get Booking now allow passing and displaying information about the ancillary vendor.
Get Booking now returns the `bookingId`, which allows you to identify your booking type (for example NDC order or Sabre PNR locator).
Cancel Booking now allows performing partial air content cancellation.
Get Booking now returns a price quote expiration indicator via the `hasValidPricing` property.
Get Booking now returns the IATA number of the ticket issuing agency, the ID associated with the traveler, as well as CSL hotel commission information.
Further enhancements to the error handling logic – additional scenarios are now covered across all BM API methods. Refer to the BM API error lists for more details.

API Information

Format

JSON

Endpoint

/v1/trip/orders/

Current Version

1.21

Environment

Production

What's New

Get Booking now returns information about SSRs present in NDC bookings in a cohesive form.
Get Booking now supports multiple hidden stops.
Create Booking and Get Booking now support the corporate loyalty program type (`CORPORATE_LOYALTY_ID`) for NDC bookings with American Airlines.
Get Booking and Modify Booking now allow displaying and changing room product code details.
An additional identity document type `FISCAL_ID`, which is applicable to NDC bookings, is now supported in Create Booking and Get Booking.
Create Booking and Get Booking now support creation and display of name reference code.
Create Booking and Get Booking now allow passing and displaying information about the ancillary vendor.
Get Booking now returns the `bookingId`, which allows you to identify your booking type (for example NDC order or Sabre PNR locator).
Cancel Booking now allows performing partial air content cancellation.
Get Booking now returns a price quote expiration indicator via the `hasValidPricing` property.
Get Booking now returns the IATA number of the ticket issuing agency, the ID associated with the traveler, as well as CSL hotel commission information.
Further enhancements to the error handling logic – additional scenarios are now covered across all BM API methods. Refer to the BM API error lists for more details.

Business Value

Users can now review special service requests stored within an NDC booking. For instance, it is possible to check special meals selected for a particular flight.
Exposing the ` hiddenStops` array in the Get Booking method allows users to verify whether a selected flight has any hidden stops, as well as obtain more information regarding these stops if applicable.
Corporate loyalty programs for American Airlines NDC content can now be submitted using the Create Booking method. This information is also returned by Get Booking.
Users can now display the room product code and modify it via the Get Booking and Modify Booking methods respectively. This new parameter makes it possible to match information from the booking key when it is needed during hotel re-shop.
A new identity document type is now supported for NDC content in the Create Booking and Get Booking methods. `FISCAL_ID` can be submitted for tax identification numbers of Argentina, Bolivia and Ecuador. To enable this functionality in the Get Booking method, `returnFIscalId` must be set to `true` within the `extraFeatures` object.
Traveler information is now expanded in the Create Booking and Get Booking methods. Users can provide a `nameReferenceCode` that might be required to complete a booking, for instance by Abacus agencies.
It is now possible to specify an ancillary vendor code in the Create Booking method. This information is also available in the Get Booking response.
The `bookingId` is now returned in the Get Booking response. This parameter currently returns either the PNR locator for traditional flight content or the NDC `orderId` for NDC/mixed content.
Partial air cancellation is now permitted. For example, our API allows cancellation of selected traditional flight segments or all NDC content, leaving some traditional segments and car or hotel details.
Users can now verify whether the price quote information is valid by checking the expiration indicator under the `hasValidPricing` parameter.
The agency IATA number of the ticket issuer is now available in the Get Booking response. This allows for an easy identification of issuer details, especially for users who rely on branch infrastructure.
The ID associated with a traveler is now supported by the Get Booking method. It may be used for reference purposes after a PNR divide operation of the booking or a traveler name change have been performed.
Get Booking now returns information about CSL hotel commission in addition to the already supported flight commission types.

Note:

In the Response

Optional

Type: String

Description: Identifies the type of loyalty program.

Sample Value:

{
"id": "{{price_passenger_id}}",
"givenName": "John",
"surname": "Doe",
"birthDate": "1970-01-23",
"passengerCode": "ADT",
"customerNumber": "1234567",
"loyaltyPrograms": [
{
"supplierCode": "AA",
"programNumber": "BX654123C",
"programType": "CORPORATE_LOYALTY_ID"
}
]
}

Note: The corporate loyalty program type `CORPORATE_LOYALTY_ID`, applicable to NDC American Airlines bookings, is now supported.

Resolved Issues

JSON

Endpoint

/v1/trip/orders/

Current Version

1.20

Environment

Production

What's New

The Booking Management API now supports miscellaneous (OTH) segments to keep the booking active beyond the date of the last travel segment.
Get Booking now supports a new `returnOnly` option (`RETENTION_DATE`).
Create Booking now allows for NDC booking creation for multiple traveler types other than `ADT`.
Additional error handling scenarios are now covered across all BM API methods related to retention date and label. Refer to the BM API error lists for more details.

Business Value

Users can now add retention date and retention label details during booking creation (via Create Booking), as well as perform post-booking add, update, and delete operations (using Modify Booking). It is also possible to include a retention date during booking cancellation (via Cancel Booking). If present in the booking, retention date and label information are displayed using the Get Booking method.
The limitation of the `ADT` traveler type is now lifted when creating NDC bookings via the Create Booking method. However, it is still not possible to book infant travelers.
By exposing a `returnOnly` option for the `RETENTION_DATE` property in the Get Booking method, users can now restrict the set of received information to retention date and label only, or use it in combination with other `returnOnly` options.

New Features

In the Request

Optional

Parameter: CreateBookingRequest.retentionEndDate

Type: String

Description: The retention date of the booking. Used optionally to keep the booking active past the date of the last itinerary item (flight, hotel, car, etc.). After this date, the booking is set for purging.

Sample Value:

"retentionEndDate": "2023-12-26"

Note:

In the Request

Optional

Parameter: CreateBookingRequest.retentionLabel

Optional

Parameter: CancelBookingRequest.retentionEndDate

Type: String

Sample Value:

"retentionEndDate": "2023-12-26"

Note:

In the Request

Optional

Parameter: CancelBookingRequest.retentionLabel

In the Request

Optional

Parameter: CreateBoookingRequest.travelers.passengerCode

Type: String

Description: Identifies the type (age) of the traveler. To book a flight that includes infant travelers, pass `INF`. Pass `INY` to indicate an infant without an assigned seat, or pass `INS` to indicate an infant with a seat. Used for flights and hotel bookings respectively.

Sample Value:

"travelers": [
{
"id": " Passenger1",
"givenName": "John",
"surname": "Doe",
"birthDate": "1970-01-23",
"passengerCode": "STU"
}
]

Note: Additional traveler types (except for infant passenger codes) are now supported during NDC booking creation.

In the Request

Optional

Parameter: GetBoookingRequest.returnOnly

Type: Array

Description: Lists the response sections returned by the service. If this array is empty or not provided, the full response structure is returned. By using this option, the application may exclude or simplify calls of downline APIs, which usually results in a significant performance boost.

Sample Value:

{
"confirmationId": "AABBCC",
"returnOnly": ["RETENTION_DATE"]
}

Note: A new `RETENTION_DATE` option is available to display retention date and label information.

Get Booking logic is enhanced to return car loyalty and vehicle quantity information.
Get Booking now supports a new `extraFeatures` functionality to preserve backward compatibility. Additional changes to some of the existing endpoint capabilities are also introduced.
Get Booking now displays additional flight details – marketing and operating airline names.
The cancellation logic for hotel segments has been improved in the Cancel Booking method.
Get Booking now supports displaying Secure Flight Passenger Data (SFPD) for NDC bookings.
Modify Booking now permits NDC booking modifications (limited functionality).
Further enhancements to the error handling logic – additional scenarios are now covered across all BM API methods. Refer to the BM API error lists for more details.

API Information

Format

JSON

Endpoint

/v1/trip/orders/

Current Version

1.19

Environment

Production

What's New

Get Booking logic is enhanced to return car loyalty and vehicle quantity information.
Get Booking now supports a new `extraFeatures` functionality to preserve backward compatibility. Additional changes to some of the existing endpoint capabilities are also introduced.
Get Booking now displays additional flight details – marketing and operating airline names.
The cancellation logic for hotel segments has been improved in the Cancel Booking method.
Get Booking now supports displaying Secure Flight Passenger Data (SFPD) for NDC bookings.
Modify Booking now permits NDC booking modifications (limited functionality).
Further enhancements to the error handling logic – additional scenarios are now covered across all BM API methods. Refer to the BM API error lists for more details.

Business Value

You may now check the vehicle quantity in the Get Booking response, as well as verify car loyalty information.
With `extraFeatures` exposed in Get Booking, you can take advantage of additional functionalities in a backward-compatible manner. This is a temporary solution to further expand Get Booking capabilities.
Flight information is now expanded in the Get Booking method, which allows you to obtain the marketing and operating airline names both for ATPCO and NDC bookings.
Additional logic added to the Cancel Booking method supports hotel segment cancellation, providing a workaround for scenarios in which downline APIs do not contain product information for hotel bookings.
Secure Flight Passenger Data document details are now available for NDC bookings in the Get Booking response. You may verify if SFPD details are present in your NDC bookings.
With Modify Booking permitting modifications of NDC bookings, you can update traveler-related details allowed by the airline.

Resolved Issues

In the Request

Optional

Description: DE273372: Cancel Booking validation expanded to check multiple objects of the `designatePrinters` array.

In the Request

Optional

Description: DE277365: Create Booking issue fixed. Contact information duplication logic is now limited to the first traveler in case of NDC bookings with multiple passengers.

Get Booking now supports new hotel-related capabilities, i.e., city location code, passive hotel segments, and loyalty details for legacy bookings.
The Get Booking logic is enhanced to return additional traveler details, such as phones and remarks associated with a name.
Significant changes are made to the Check Flight Ticket method to support additional information for the refund operation.
Check Flight Ticket now returns new details regarding exchange eligibility.
Create Booking now allows you to specify asynchronous wait time to mitigate the issue with finalized bookings being redisplayed.
Create Booking now supports adding Secure Flight Passenger Data (SFPD) to NDC bookings.
Further enhancements to the error handling logic – additional scenarios are now covered across all BM API methods with more descriptive information for our users. Refer to the BM API error lists for more details.

API Information

Format

JSON

Endpoint

/v1/trip/orders/

Current Version

1.18

Environment

Production

What's New

Get Booking now supports new hotel-related capabilities, i.e., city location code, passive hotel segments, and loyalty details for legacy bookings.
The Get Booking logic is enhanced to return additional traveler details, such as phones and remarks associated with a name.
Significant changes are made to the Check Flight Ticket method to support additional information for the refund operation.
Check Flight Ticket now returns new details regarding exchange eligibility.
Create Booking now allows you to specify asynchronous wait time to mitigate the issue with finalized bookings being redisplayed.
Create Booking now supports adding Secure Flight Passenger Data (SFPD) to NDC bookings.
Further enhancements to the error handling logic – additional scenarios are now covered across all BM API methods with more descriptive information for our users. Refer to the BM API error lists for more details.

Business Value

Users can now check the hotel location as well as loyalty information (for legacy hotel bookings) in the Get Booking response. Moreover, passive hotel segments now contain much more details in the `allSegments` section of the Get Booking response.
Information about phones and remarks associated with a given name is now available in the Get Booking response to agencies with the Passenger Name Association (PNAPNR) option active in their TJR settings.
Refundability information is expanded in the Check Flight Ticket method. Users can verify eligibility for Automated Refunds and obtain details regarding refund penalties if they are applicable.
Users can now verify whether tickets can be exchanged using the Check Flight Ticket method. If any exchange penalties apply, this information is also available in the API response.
Adding the `asynchronousUpdateWaitTime` property to the Create Booking method helps mitigate the issue of booking redisplay delay related to asynchronous processing in downline systems (applicable primarily to NDC bookings).
A new NDC functionality is added to the Create Booking method, allowing our users to include a Secure Flight Passenger Data loyalty document during booking creation. This makes it easier to meet the fulfillment requirements.

In the Response

Optional

Description: DE269868: Get Booking bug fixed, which prevented information about ticket coupons from being displayed once a flight schedule change had occurred. A new property named `allCoupons` has been introduced.

In the Request

Optional

Description: DE269887: Create Booking issue fixed. The postal code is now validated when billing address information is passed.

In the Request

Optional

Description: DE270100: Cancel Booking issue fixed. The validation step that prevented voiding of tickets with coupons in the ACTL status is now lifted.

Create Booking and Get Booking now support new NDC capabilities, i.e. multi-adult traveler bookings, contact information associated with a name, and additional identity document types (Visa, Known Traveler Number, and Redress Number).
Get Booking logic is enhanced to return additional brand details for NDC bookings.
Additional mappings are added to the Get Booking method to return extra information about identity documents (lap-child indicator, residence country code).
Information on the issuing country for the Known Traveler Number and Redress Number documents as well as the expiration date for VISA documents (DOCO formats) are now required when using the Create Booking method.
Get Booking now returns information about the purchase deadline stored in the Price Quote (PQ).
The default logic for unmapped passenger types returned in Get Booking is now updated – the passenger code is always returned.
Create Booking now supports adding endorsement details as a new pricing qualifier.
Modify Booking now supports modification of identity documents.
Further enhancements to the error handling logic – additional scenarios are now covered across all BM API methods with more descriptive information for the users. Refer to the BM API error lists for further details.

API Information

Format

JSON

Endpoint

/v1/trip/orders/

Current Version

1.17

Environment

Production

What's New

Create Booking and Get Booking now support new NDC capabilities, i.e. multi-adult traveler bookings, contact information associated with a name, and additional identity document types (Visa, Known Traveler Number, and Redress Number).
Get Booking logic is enhanced to return additional brand details for NDC bookings.
Additional mappings are added to the Get Booking method to return extra information about identity documents (lap-child indicator, residence country code).
Information on the issuing country for the Known Traveler Number and Redress Number documents as well as the expiration date for VISA documents (DOCO formats) are now required when using the Create Booking method.
Get Booking now returns information about the purchase deadline stored in the Price Quote (PQ).
The default logic for unmapped passenger types returned in Get Booking is now updated – the passenger code is always returned.
Create Booking now supports adding endorsement details as a new pricing qualifier.
Modify Booking now supports modification of identity documents.
Further enhancements to the error handling logic – additional scenarios are now covered across all BM API methods with more descriptive information for the users. Refer to the BM API error lists for further details.

Business Value

New NDC functionalities are added to the Create Booking and Get Booking methods. Customers can now create and display multi-adult traveler NDC bookings. Travelers can have dedicated contact information (phones and emails) assigned to them. Support for new types of identity documents (Visa, Known Traveler Number, Redress Number) is added as well.
Information about additional branded fare (Price Class) attributes is now available in the Get Booking response for NDC bookings.
Mapping for identity documents is expanded to support residence country code and lap child indicator details in the Get Booking method, for multiple DOCS, DOCO, and DOCA documents.
Industry mandate regarding mandatory information (expiration date for visa documents; issuing country details for Redress Number and Known Traveler Number documents) is incorporated in the Create Booking method.
Customers can now verify in the Get Booking response when a stored fare must be ticketed. This is an additional piece of information to plan fulfillment operations accordingly.
Get Booking now allows for identification of traveler code details even if the specific mapping logic is missing. Instead of the ‘SPECIAL’ text, the traveler code always contains a 3-letter code (https://central.sabre.com/s/article/passenger-type-codes-index).
Endorsement information is now supported in the Create Booking method. Customers can specify desired details as one of the pricing qualifiers.
Additional functionality is implemented to let customers add, update, and delete identity documents (such as passports), secure flight passenger data, visa documents, and more.

Resolved Issues

JSON

Endpoint

/v1/trip/orders/

Current Version

1.16

Environment

Production

What's New

Get Booking now supports unmasking of payment card details for customers with a specific EPR keyword (CCVIEW).
Get Booking now returns two additional passenger type codes: LBR and LNN.
BM API methods contain timestamp information about when a specific request was processed by the Sabre systems.
Check Flight Tickets logic is enhanced to properly identify tickets eligible for the void operation in case of bookings containing surface segments (ARNK).
Modify Booking now supports modifications of special service requests (SSRs) associated with flights.
Error handling improvements – additional scenarios are now covered across all BM API methods with more descriptive information for the users. Refer to BM API error lists for further details.

Business Value

The Get Booking method allows returning of unmasked payment card information for the customers that have EPRs with the CCVIEW keyword.
Customers can now obtain information regarding LBR and LNN passenger types, which are used by Air New Zealand for their SEAT ONLY fares.
Timestamp details added to BM API responses improve troubleshooting of potential customer issues by helping locate the API call within internal logging applications.
Additional logic is added to the Check Flight Tickets method, allowing customers to properly validate by means of `isVoidable` property whether tickets issued for an itinerary with ARNK segments are eligible for the void operation.
Additional logic is implemented to let customers add, update, and delete flight-associated special service requests.

New Features

In the Request

Optional

Description: DE253517: Cancel Booking issue fixed, in which a simultaneous changes error affected the void flow. New retry logic has been implemented to recover from those scenarios.

In the Response

Optional

Description: DE258285: Get Booking issue fixed, in which the leading zero was missing from the payment card expiry date.

Get Booking and Create Booking now support additional gender type codes (UI and XI) for identity document special services (DOCO).
Get Booking now returns form of payment information for an expanded list of cash and check entries.
Group booking logic is enhanced in the Get Booking method. The traveler’s association is now determined by the means of an additional `isGrouped` boolean value.
Modify Booking now supports modification of the traveler details stored in the booking (name, surname, phone and email information, frequent flyer loyalty details) for traditional content (e.g.: ATPCO flights).
Added support for adding and updating the travel agency customer identifier (DK number).
Modify Booking now supports modifications of group bookings. It is possible to adjust the traveler list associated with a group.
Added support for special service request (SSR) modifications.
Model improvements – property patterns were updated to reflect additional customer requirements and/or system limitations.

API Information

Format

JSON

Endpoint

/v1/trip/orders/

Current Version

1.15

Environment

Production

What's New

Get Booking and Create Booking now support additional gender type codes (UI and XI) for identity document special services (DOCO).
Get Booking now returns form of payment information for an expanded list of cash and check entries.
Group booking logic is enhanced in the Get Booking method. The traveler’s association is now determined by the means of an additional `isGrouped` boolean value.
Modify Booking now supports modification of the traveler details stored in the booking (name, surname, phone and email information, frequent flyer loyalty details) for traditional content (e.g.: ATPCO flights).
Added support for adding and updating the travel agency customer identifier (DK number).
Modify Booking now supports modifications of group bookings. It is possible to adjust the traveler list associated with a group.
Added support for special service request (SSR) modifications.
Model improvements – property patterns were updated to reflect additional customer requirements and/or system limitations.

Business Value

You can now obtain (Get Booking) and pass (Create Booking) identity document details intended for infant travelers. An enhancement for the new codes UI (Undisclosed Infant) and XI (Unspecified Infant) is implemented with additional logic to automatically determine proper code usage based on the traveler’s age and type.
Additional logic is added in Get Booking, which allows you to obtain the form of payment information stored in the booking when using FOP entries with `CA`, `CK`, and `CHEQUE` values.
Get Booking now returns additional information regarding group bookings. You can verify a traveler’s assignation to a group by checking the `isGrouped` property value.
You may modify traveler information stored in traditional bookings. Updates of the traveler’s name and surname, full control over the contact details (phones and emails) as well as frequent flyer data are now possible.
Additional logic is implemented to let users add and update the travel agency customer identifier (DK number).
Modify Booking now supports group booking modifications. You can verify traveler assignation within a group and add, update and delete this data as they wish (these operations may be restricted by the airline).
The first iteration of the SSR modification is released (limited functionality). It includes automatic infant SSR handling when associated infant traveler information is changed.

"travelers": [
{
"givenName": "JOE",
"surname": "DOE",
"birthDate": "2022-03-04",
"passengerCode": "INF",
"isGrouped": true
}
]

Note: The `birthDate` property is now required for infant travelers due to the implementation of the automatic INFT SRR logic.

Resolved Issues

Get Booking now returns additional seat information, like status and IATA-defined characteristic codes, for both ATPCO and NDC flight bookings.
Create Booking now supports passing flight-related information for CSL hotel bookings.
Get Booking now returns additional information regarding baggage allowance for NDC bookings. Customers can now easily identify baggage allowance information regardless of the booking type (APTCO or NDC).
Get Booking now supports group bookings.

API Information

Format

JSON

Endpoint

/v1/trip/orders/

Current Version

1.14

Environment

Production

What's New

Get Booking now returns additional seat information, like status and IATA-defined characteristic codes, for both ATPCO and NDC flight bookings.
Create Booking now supports passing flight-related information for CSL hotel bookings.
Get Booking now returns additional information regarding baggage allowance for NDC bookings. Customers can now easily identify baggage allowance information regardless of the booking type (APTCO or NDC).
Get Booking now supports group bookings.

Business Value

Seat logic has been expanded in the Get Booking method. For both ATPCO and NDC bookings, you can now retrieve status details (seat code and a meaningful description), as well as characteristic codes associated with the seat.
Additional logic has been added to the Create Booking method, allowing you to send flight-related information to hotel vendors when booking CSL content.
You can now obtain information about baggage allowance details not only for ATPCO flight bookings, but also NDC orders in the normalized response structure.
Get Booking will now return information regarding group bookings. You can verify group name, ID, number of travelers already added within a group, as well as the number of remaining names that are missing.

"associatedFlightDetails": {
"arrivalAirlineCode": "AA",
"arrivalFlightNumber": 1067,
"arrivalTime": "12:30",
"departureAirlineCode": "UA",
"departureFlightNumber": 543,
"departureTime": "09:15"
}

Functional Updates And Enhancements

In the Request

Optional

Parameter: GetBookingRequest.returnOnly

Type: Array

Description: Lists the response sections returned by the service. If this list is empty or not provided, then the full structure is returned. By using this option, the application may exclude or simplify calls of downline APIs, which usually results in a significant performance boost.

Sample Value:

{
"confirmationId": "BFGBFG",
"returnOnly":[
"FORMS_OF_PAYMENT"
]
}

Note: FORMS_OF_PAYMENT value has been added to the existing list of options.

In the Response

Optional

Parameter: GetBookingResponse.fareOffers

Type: Array

Description: Lists ancillary offers for selected flights identified by itemId flight references.

Sample Value:

"fareOffers": [
{
"travelerIndices": [
1
],
"flights": [
{
"itemId": "8"
}
],
"cabinBaggageAllowance": {
"baggagePieces": [
{
"numberOfPieces": 1
}
]
},
"checkedBaggageAllowance": {
"baggagePieces": [
{
"maximumWeightInKilograms": 30
}
]
}
}
]

Note: Baggage allowance details will now be returned for NDC bookings.

Resolved Issues

A new method Modify Booking (BETA) has been released.
GetBooking will start returning the form of payment information, which is stored in the booking.
GetBooking will start supporting payment policy details used for CSL hotel bookings.
GetBooking will start returning additional information regarding hotel content. Customers can now easily identify the type of hotel booking.
CreateBooking will start considering name associated phone numbers with higher priority rather than general contact information for hotel bookings.

API Information

Format

JSON

Endpoint

/v1/trip/orders/

Current Version

1.13

Environment

Production

What's New

A new method Modify Booking (BETA) has been released.
GetBooking will start returning the form of payment information, which is stored in the booking.
GetBooking will start supporting payment policy details used for CSL hotel bookings.
GetBooking will start returning additional information regarding hotel content. Customers can now easily identify the type of hotel booking.
CreateBooking will start considering name associated phone numbers with higher priority rather than general contact information for hotel bookings.

Business Value

Customers can now perform modifications of the existing booking by using Modify Booking method. The initial release allows for CSL hotel content changes. The capabilities of this new method are described under the URL: https://developer.sabre.com/docs/rest_apis/trip/orders/booking_management/help_doc?page=modify-booking-0
Get Booking has been successfully moved to the PCI cluster. This change allowed adding functionality to return Form of Payment (FOP) information stored in the bookings.
Additional logic has been implemented in Get Booking method, to return details regarding payment policy and type of the hotel content. Customers can now obtain additional information about selected payment policy and distinguish between legacy and CSL (Sabre or aggregators) booking source.
Name associated phone numbers will now take precedence over general contact information during the hotel booking creation process.

New Features

In the Response

Optional

Parameter: GetBookingResponse.payments.formsOfPayment

JSON

Endpoint

/v1/trip/orders/

Current Version

1.12

Environment

Production

What's New

GetBooking will start returning additional information regarding traveler association with flights and cars.
GetBooking will start supporting additional information associated with hotel bookings: corporate id and arrival/departure flight details.
GetBooking will start returning booking signature used to verify the state of the booking during modification (more information soon!).
GetBooking will start expanding traveler information based on the guest details stored in the hotel booking.
GetBooking will start returning agency IATA number if booking contains CSL (Content Services for Lodging) content.
CancelBooking schema will be slightly improved by removing unused, duplicated properties related to queue placement.

Business Value

Customers can now retrieve additional details associated with the existing hotel booking. Information like corporate id, guest’s email and phone numbers, as well as arrival and departure flight data, will be now, if applicable, present in the GetBooking response.
Introducing a booking signature will allow verifying the state of the booking and prevent from doing unexpected modifications.
Additional logic has been implemented to verify and retrieve guest information. This ensures more cohesive data in reference to traveler information returned by GetBooking.
Presence of the IATA number in the GetBooking response is a supplementary source of agency identification by the customers.
The removal of unused elements from the schema lets us maintain a high quality and complete API product.

Description: US1335214: Adding support for the infant tickets containing “INF” string prefix in the CancelBooking and VoidFlightTIckets methods.

CreateBooking will start supporting the optional issuing country information for Known Traveler Number documents (DOCO formats).
CreateBooking will start supporting information about the place and date of issue for VISA identity documents (DOCO formats) as optional fields.
GetBooking will start supporting the expiration date for Visa documents (DOCO formats).
Void/Refund/Check Flight Tickets methods will start processing conjunctive ticket numbers.
GetBooking will start returning additional flight-related information: hidden stops and the number of seats occupied by the travelers.
GetBooking will allow obtaining additional information stored for hotel bookings like the guest association to a room and loyalty numbers.

API Information

Format

JSON

Endpoint

/v1/trip/orders/

Current Version

1.11

Environment

Production

What's New

CreateBooking will start supporting the optional issuing country information for Known Traveler Number documents (DOCO formats).
CreateBooking will start supporting information about the place and date of issue for VISA identity documents (DOCO formats) as optional fields.
GetBooking will start supporting the expiration date for Visa documents (DOCO formats).
Void/Refund/Check Flight Tickets methods will start processing conjunctive ticket numbers.
GetBooking will start returning additional flight-related information: hidden stops and the number of seats occupied by the travelers.
GetBooking will allow obtaining additional information stored for hotel bookings like the guest association to a room and loyalty numbers.

Business Value

Customers can now specify issuing country details for Known Traveler Number documents, by passing required information in CreateBooking request.
Customers can now provide information regarding the place and date of issue for VISA identity documents in CreateBooking request. These details are considered optional.
The expiration date for Visa documents was included in the identity documents information in GetBooking. Information is consistent with the same functionality introduced in CreateBooking.
Customers can now use conjunctive ticket numbers (e.g.: 0167662548958/59) in their Void/Refund/Check Flight Tickets requests.
By adding hidden stop and number of seats information customers can obtain additional details associated with the existing air booking.
By supporting guest to room association and loyalty numbers customers can obtain additional details associated with the existing hotel booking.

New Features

In the Response

Optional

Parameter: GetBookingResponse.flights.hiddenStopAircraftTypeCode

CreateBooking will start supporting the expiration date for Visa documents (DOCO formats).
GetBooking will start returning information about delivery and collection site/address present in the car bookings in a cohesive form.
GetBooking will allow obtaining information about the past date indicator for the flown flights.
GetBooking will start returning additional traveler information regarding name-associated phone numbers.
GetBooking will allow obtaining additional information stored in manual PQs. Now it is possible to check fare construction details, flight association and much more.
GetBooking has now improved roundtrip journeys logic – it can verify whether selected trip contains a multi-airport city.

API Information

Format

JSON

Endpoint

/v1/trip/orders/

Current Version

1.10

Environment

Production

What's New

CreateBooking will start supporting the expiration date for Visa documents (DOCO formats).
GetBooking will start returning information about delivery and collection site/address present in the car bookings in a cohesive form.
GetBooking will allow obtaining information about the past date indicator for the flown flights.
GetBooking will start returning additional traveler information regarding name-associated phone numbers.
GetBooking will allow obtaining additional information stored in manual PQs. Now it is possible to check fare construction details, flight association and much more.
GetBooking has now improved roundtrip journeys logic – it can verify whether selected trip contains a multi-airport city.

Business Value

Customers can now follow the new industry mandate introduced by the IATA regarding the expiration date for Visa documents, by passing required information in CreateBooking request.
By adding delivery and collection site/address information customers can obtain the custom details specified for car bookings.
Name associated phone numbers were added to travel information in GetBooking. Information is consistent with the same functionality introduced in CreateBooking.
Added past date indicator allows to quickly identify a flown flight.
Additional details returned for manual PQs were added to further support pricing data analysis.
Added internal multi-airport city database, which improves journeys functionality. It allows identifying roundtrips with departure and arrival at the same city.

"phones": [
{
"number": "+1-555-123-4567",
"label": "M"
}
],

Note: Name associated phones will be removed from GetBookingResponse.contactInfo.phones array in the future major release of the BM API.

Functional Updates And Enhancements

In the Response

Optional

Parameter: GetBookingResponse.fares.fareConstruction

Type: Array

Description: Lists the components used to construct the fare.

Sample Value:

"fareConstruction": [
{
"flights": [
{
"itemId": "50"
}
],
"flightIndices": [
1
],
"fareBasisCode": "KL40MALP",
"isCurrentItinerary": true,
"checkedBaggageAllowance": {
"totalWeightInKilograms": 10
}
},

Note: Additional information is now returned for manual PQs.

In the Request

Optional

Parameter: CreateBookingRequest.travelers.identityDocuments.expiryDate

Type: string

Description: The expiration date of the identity document.

Sample Value:

"identityDocuments": [
{
"documentNumber": "0123456789",
"expiryDate": "2022-07-09",
"hostCountryCode": "US",
"documentType": "VISA",
"givenName": "John",
"middleName": "Jack",
"surname": "Smith",
"placeOfIssue": "FR",
"issueDate": "2021-05-21"
}
]

Note: The expiration date is now supported when sending Visa DOCO.

Resolved Issues

JSON

Endpoint

/v1/trip/orders/

Current Version

1.9

Environment

Production

What's New

CreateBooking will support booking cars. Implementation covers adding car content into the reservation by means of a booking key.
CreateBooking will support Payment Service Directive 2 (PSD2) compliant Strong Customer Authentication (SCA) for payment cards when booking hotel content.
CreateBooking will now allow creating name-associated phone numbers.

Business Value

Car booking is now integrated into CreateBooking. New capabilities will allow booking cars exclusively and alongside flights and/or hotel content in a single request.
PSD2 is a new set of rules changing how consumers confirm their identity when making purchases online. The rules apply in full for card payments and CreateBooking will now support Strong Customer Authentication (SCA) for hotel bookings.
Name-associated phone numbers were added to provide additional flexibility in terms of contact information stored in the booking.

Resolved Issues

In the Request

Optional

Description: DE211540: Fixing bug in CreateBooking logic - incorrect segment numeration when ARNK segments are included in the booking.

In the Response

Optional

Description: DE212274: Fixing bug in GetBooking response to return proper details about passenger type code (age information instead of generic code, e.g.: C04 instead of CNN), under GetBookingResponse.travelers.passengerCode.

In the Response

Optional

Description: DE213068: Fixing bug in GetBooking response to return missing fare rules under GetBookingResponse.fareRules for INF passenger, once the booking is ticketed.

CreateBooking will start supporting booking ancillaries. Initial implementation covers the air extras booking process for ATPCO flights. You can now assign selected ancillaries to a particular traveler, in a single request.
CreateBooking will support sending special service requests (SSR). This is another functionality further improving the trip experience – you can notify the airline about traveler’s preferences/additional information in an easy way.
GetBooking will start returning additional fare data obtained from Price Quote (PQ) details. Now it is possible to check the status of the fare, flight association, brand details and much more.
GetBooking will allow obtaining information about booked ancillaries. More to come with the next releases.
GetBooking will start returning information about SSRs present in the booking in a cohesive form.
CancelBooking/VoidFlightTickets/RefundFlightTickets will run corresponding ticket related operations for the customers with AUTO-END functionality activated on the PCC level.

API Information

Format

JSON

Endpoint

/v1/trip/orders/

Current Version

1.8

Environment

Production

What's New

CreateBooking will start supporting booking ancillaries. Initial implementation covers the air extras booking process for ATPCO flights. You can now assign selected ancillaries to a particular traveler, in a single request.
CreateBooking will support sending special service requests (SSR). This is another functionality further improving the trip experience – you can notify the airline about traveler’s preferences/additional information in an easy way.
GetBooking will start returning additional fare data obtained from Price Quote (PQ) details. Now it is possible to check the status of the fare, flight association, brand details and much more.
GetBooking will allow obtaining information about booked ancillaries. More to come with the next releases.
GetBooking will start returning information about SSRs present in the booking in a cohesive form.
CancelBooking/VoidFlightTickets/RefundFlightTickets will run corresponding ticket related operations for the customers with AUTO-END functionality activated on the PCC level.

Business Value

Ancillaries and SSRs were integrated into CreateBooking and GetBooking. New capabilities will allow communicating with the airlines and pass/receive information about trip details, requirements, or enhancements.
Additional details for air fares were added to further support pricing data analysis.
Implemented AUTO-END functionality verification helps execute void/refund operations in a predictable manner.

New Features

In the Request

Optional

Parameter: CreateBookingRequest.travelers.specialServices

Type: array

Description: Lists special services for a traveler.

Sample Value:

"specialServices": [
{
"code": "XBAG",
"message": "PREPAID",
"flightIndices": [
1
]
}
]

In the Request

Optional

Parameter: CreateBookingRequest.travelers.ancillaries

Optional

Description: DE200410: Pattern correction for ticketing printers to allow using 1R and 1T codes (settlement methods for Russia).

In the Response

Optional

Description: DE207661: Adding additional information in GetBooking response under GetBookingResponse.payments.flightCurrentTotals property, which contains a sum of charges only for issued tickets – voided, refunded/exchanged items are not taken into consideration.

In the Request

Optional

Description: DE200951: VoidFlightTickets request validation, preventing from specifying multiple printer types under single printer address object.

In the Response

Optional

Description: DE206825: Fixing bug in GetBooking response to return information about identity document status, under GetBookingResponse.flights.identityDocuments.status.

CreateBooking will start support for hotels. By adding a hotel object to your createBookingRequest you will be able to add a hotel to your booking with just one API call. The object is normalized and supports all content types, including Sabre's Content Services for Lodging.
For all those who asked for more details on fares - We have you covered now! GetBooking will return details for fares based on price quotes for ATPCO bookings or based on the NDC orders. More to come with the next releases.

API Information

Format

JSON

Endpoint

/v1/trip/orders/

Current Version

1.7

Environment

Production

What's New

CreateBooking will start support for hotels. By adding a hotel object to your createBookingRequest you will be able to add a hotel to your booking with just one API call. The object is normalized and supports all content types, including Sabre's Content Services for Lodging.
For all those who asked for more details on fares - We have you covered now! GetBooking will return details for fares based on price quotes for ATPCO bookings or based on the NDC orders. More to come with the next releases.

Business Value

Hotels were integrated into the seamless workflow for createBooking. It was never easier to book a hotel using an API.
Details for air fares were added to support you with analyzing the pricing data or optimizing you back-office workflows.

New Features

In the Request

Optional

Parameter: CreateBookingRequest.hotel

Type: object

Description: The object allows to add a hotel to your createBooking-request. This works across the different content types for hotels in Sabre.

Sample Value:

"hotel": {
"useCsl": true,
"bookingKey": "d9e73f0d-5f90-4b43-9c86-2d88a732604f",
"corporateDiscountCode": 6878700,
"rooms": [
{
"isSmoking": false,
"bedTypeCode": 3,
"physicalDisabilityCode": 3,
"roomExtras": [
{
"roomExtraType": 26,
"quantity": 1,
"amount": "100.00"
}
],
"travelerIndices": [
1
]
}
],
"specialInstruction": "Need a wi-fi in the room.",
"paymentPolicy": "DEPOSIT",
"formOfPayment": 1
}

In the Response

Optional

Parameter: getBookingResponse.fares

Type: Array

Parameter: getBookingResponse.flights.identityDocuments

Type: array

Description: The new array will return all identityDocuments applicable for a given flight. This will include the status. The documents can be linked the the identityDocuments under travelers using the itemId.

Sample Value:

"identityDocuments": [
{
"itemId": "T2zMo3MZuQny8lc7jbejvKdGMdUxTy/cEuT+a9MiUDeRQpQIGdYdH7Glwy1GlY53faZ55jWGCwrKyWxjJFzuNg==",
"status": "Confirmed"
}
]

Note: ItemId is a unique identifier to easily link the same documents from flights.identityDocuments with travelers.identityDocuments.

In the Response

Optional

Parameter: createBookingResponse.errors

Type: n/a

Description: The error message related to addition of an identity document

Sample Value:

UNABLE_TO_ADD_SPECIAL_SERVICE

Note: previously the error type was: UNABLE_TO_ADD_IDENTITY_DOCUMENT

Resolved Issues

JSON

Endpoint

/v1/trip/orders/

Current Version

1.6

Environment

Production

What's New

GetBooking will return additional data for the creation of the booking. This will include the sine of the user who created it, creation date & time, the PCC the booking was created in, the PCC the creating user is coming from, and the prime host ID.
GetBooking will start returning structured data about Other Service Information (OSI). The information provided will include the airline, chain (hotels) or vendor (cars, trains, cruises) codes, and the service message. Optionally, the traveler index can also be returned.
CreateBooking will support sending other service information (OSI).
CreateBooking will allow filtering the profiles by ID.
CreateBooking will now automatically send infant traveler SSRs to the airline.
CheckFlightTickets will start supporting requests by confirmationId. This allows you to check all ATPCO-Tickets of a reservation and check the refund or void option of a NDC Order.
CancelBooking will support voids or refunds for NDC orders. Simply provide the offerItemId to the request and we take care of the rest.

Business Value

Full integration of void and refund in cancelBooking across ATCPO and NDC content.
Support for other service information in createBooking and getBooking.
CreateBooking will now automatically send infant traveler SSRs to the airline.

Sample Value:

"confirmationId": "GLEBNY"

Note: Not supported for NDC Orders.

In the Request

Optional

Parameter: VoidFlightTicketsRequest.confirmationId

Type: String

Description: Use the confirmationId to void the entire list ATPCO tickets in a PNR.

Sample Value:

"confirmationId": "GLEBNY"

Note: Not supported for NDC Orders.

Resolved Issues

createBooking - New method for booking various content.
checkFlightTickets - New method to verify voidability and refundability for flight tickets.
refundFlightTickets - New method to refund flight tickets incl. the option to apply refund qualifiers.
Post Processing Options - Send and email or place the booking on one or more queues after transaction finished.
Printer Designation - Apply a printer profile for a void or refund transaction.

API Information

Format

JSON

Endpoint

/v1/trip/orders/

Current Version

1.5

Environment

Production

What's New

createBooking - New method for booking various content.
checkFlightTickets - New method to verify voidability and refundability for flight tickets.
refundFlightTickets - New method to refund flight tickets incl. the option to apply refund qualifiers.
Post Processing Options - Send and email or place the booking on one or more queues after transaction finished.
Printer Designation - Apply a printer profile for a void or refund transaction.

Business Value

Create Booking is used to book various Sabre content within a single API call. It creates either a Sabre order or a Sabre PNR.
Check and Refund Flight Tickets are used to refund tickets with a two-step process. These methods return options to refund or void a ticket (including refundable amounts).
Added post-processing options are used to place a PNR on one or more queues, or to send an email after the transaction finished.
Support for printer profiles allows the designation of a printer using a printer profile number.

In the Response

Required

Parameter: Support for ARUNK-Segments

Type: string

Description: Get Booking will return a special type, "ARNK", for ARUNK segments under allSegments.

Sample Value:

"allSegments": [
{
"id": "8",
"type": "FLIGHT",
"text": "2",
"vendorCode": "EY",
"startDate": "2021-05-10",
"startTime": "11:20:00",
"startLocationCode": "FRA",
"endDate": "2021-05-10",
"endTime": "19:40:00",
"endLocationCode": "AUH"
},
{
"id": "9",
"type": "ARNK"
}
],

JSON

Endpoint

/v1/trip/orders/getBooking | /v1/trip/orders/cancelFlightTickets | /v1/trip/orders/cancelBooking

Current Version

1.4

Environment

Production

What's New

Additional details were added for hotels, cars and trains. Payment details per segment are returned now.
hotelTotals returns information about fees included in the payment now.
With this version the service starts returning information about identity documents based on Special Service Requests (SSR) for flights.
Application will now return loyalty program information per traveler.
CancelBooking and cancelFlightTickets supports AUTO-E setup now.
CancelBooking and cancelFlightTickets allow now a custom value for the "receive from" field.

Business Value

The addition of loyalty programs and identity documents in getBooking mark the first step in supporting special service requests for flights.

Additional information was added to the GetBooking endpoint for the car element; it now provides more details about the rate code, vehicle type, and vendor contact information.

API Information

Format

JSON

Endpoint

/v1/trip/orders/getBooking /v1/trip/orders/cancelFlightTickets /v1/trip/orders/cancelBooking

Current Version

1.3

Environment

Production

What's New

Additional information was added to the GetBooking endpoint for the car element; it now provides more details about the rate code, vehicle type, and vendor contact information.

Business Value

Extensions in GetBooking now provide more information for car bookings.

"guaranteePaymentNote": "GVI4XXXXXXXXXXX1111EXP 01 25-HOTEL"

Resolved Issues

JSON

Endpoint

/v1/trip/orders/getBooking /v1/trip/orders/cancelFlightTickets /v1/trip/orders/cancelBooking

Current Version

1.2

Environment

Production

What's New

A new method CancelFlightTickets has been introduced to the Booking Management API.
For GetBooking additional information was added to the hotel element providing more details about vendor, room and fulfillment details.
The construction of fareRules for GetBooking has been enhanced. This was done for both scenarios: Saved price quotes and issued tickets. Logic for different passenger type as well as more complex origin-destination-options has also been enhanced.

Business Value

The introduction of Cancel Flight Tickets simplifies the voiding of electronic documents for ATPCO content. Instead of handling a complex sequence of API calls this service orchestrates multiple services in one call. This includes a recovery strategy in case of failure, handling of multiple documents, performing the action in a different PCC than the home PCC and update of the reservation.

New Features

In the Request

Required

Parameter: cancelFlightTicketsRQ.tickets

Optional

Parameter: getBookingRS.hotels.guaranteeTypeName

Optional

Description: Incorrect ticketStatusCode and ticketStatusName when timestamps are overlapping.

In the Request

Optional

Description: GraphQL: Invalid input for Enum 'FlightStatusNameEnum'

In the Response

Optional

Description: Hotel refundPenalties Incorrectly display in Get Booking Response

A new feature is introduced for CancelBooking, which allows you to cancel a booking and void the corresponding tickets or EMD's in one call by specifying the flightTicketOperation "VOID" in the request.
GetBooking contains information regarding the baggage policy per flight and traveler. Now in addition, enhancements for hotel and ticket status is introduced.

API Information

Format

JSON

Endpoint

/v1/trip/orders

Current Version

1.1

Environment

Production

What's New

A new feature is introduced for CancelBooking, which allows you to cancel a booking and void the corresponding tickets or EMD's in one call by specifying the flightTicketOperation "VOID" in the request.
GetBooking contains information regarding the baggage policy per flight and traveler. Now in addition, enhancements for hotel and ticket status is introduced.

Business Value

Version 1.1 brings additional value to the Booking Management API by combining segment and ticket handling for CancelBooking, where customers had to perform multiple steps to void tickets or EMD's and then cancel the segments. It's just one call for everything now.
User will have full details about baggage allowance and related charges with the introduction of fareOffers section.

New Features

Note: Only the current status will be reflected.

In the Response

Optional

Parameter: US933173: Add Ticket Status to flightTickets

Type: string

Description: For each flightTicket the ticketStatusName and ticketStatusCode will be returned. Currently, three ticketStatusNames are supported: Issued, Voided, Exchanged/Refunded. The coupons status is not taken into consideration for definition of ticket status.

Sample Value:

{
"flightTickets": [
{
"number": "6071234567890",
"date": "2020-07-03",
"travelerIndex": 1,
"flightCoupons": [
{
"itemId": "7",
"couponStatus": "Not Flown",
"couponStatusCode": "I"
}
],
"payment": {
"subtotal": "1347.00",
"taxes": "238.70",
"total": "1585.70",
"currencyCode": "USD"
},
"ticketStatusName": "Issued",
"ticketStatusCode": "TE"
}
],
"request": {
"confirmationId": "ABCDEF",
"returnOnly": [
"TICKETS"
]
}
}

Note: Only the current status will be reflected.

Resolved Issues

This initial release of the Booking Management API introduces two methods: GetBooking and CancelBooking.

API Information

Format

JSON

Endpoint

/v1/trip/orders

Current Version

Environment

Production

What's New

This initial release of the Booking Management API introduces two methods: GetBooking and CancelBooking.

Business Value

The Booking Management API is a part of Sabre's Business Services, that allows users to manage their Sabre reservations/bookings in a better way. This API provides a normalized set of services to manage both Sabre Passenger Name Records (PNRs) and Sabre Orders, by simplifying these implementations and ensuring that both expert and novice users can integrate and adopt Sabre APIs in the most seamless way possible.

v1.21 | February 14, 2024

API Information

What's New

Business Value

New Features

In the Response

Optional

In the Response

Optional

In the Request

Optional

In the Request

Optional

In the Response

Optional

In the Response

Optional

In the Response

Optional

In the Response

Optional

In the Request

Optional

In the Response

Required

In the Response

Optional

Functional Updates And Enhancements

In the Response

Optional

In the Request

Optional

In the Request

Optional

In the Request

Optional

Resolved Issues

In the Response

Optional

In the Request

Optional

In the Request

Optional

In the Response

Optional

In the Response

Optional

v1.20 | December 6, 2023

API Information

What's New

Business Value

New Features

In the Request

Optional

In the Request

Optional

In the Response

Optional

In the Response

Optional

In the Request

Optional

In the Request

Optional

In the Request

Optional

In the Request

Optional

Functional Updates And Enhancements

In the Request

Optional

In the Request

Optional

v1.19 | October 4, 2023

API Information

What's New

Business Value

New Features

In the Request

Optional