DerbySoft GDN Seller API

TABLE OF CONTENTS

Request Payload Example

Request Payload Structure
Response
- Response Payload Example

This interface allows retrieval of all purchasable ancillary bundles associated with a specific flight offer. By submitting the offerId returned from the OfferPrice response, partners can obtain a detailed list of available bundles (e.g., baggage, seat selection, premium meals, flexibility options) and their respective prices. This enables the dynamic construction of a final offer before proceeding to the OrderCreate phase.

Version	Date	Description of Edit
V1.1	2025/11/23	Initial Commit
V2.0	2026/08/15	Added bundleCode Supported returning ssrCode for bundle included services Added taxCode in unit price tax details

Request Details
Path	V1.1	/api/flight/connectivity/search/bundleAvailability
Path	V2.0	/api/flight/connectivity/search/V2.0/bundleAvailability

Request Payload Example

{
   "offer": {
       "offerId": "167e64888d114d2ba1a79aa8cc8d0b87"
   }
}

Request Payload Structure

Key	Parent	Type	Mandatory/Optional	Description
offer	root	Object	O
offerId	offer	String	M	Use this parameter when searching for an available bundle during the initial booking process. offerId should return from offerPrice endpoint.
order	root	Object	O
supplierOrderId	order	String	M	Use this parameter when adding a bundle after a ticket has been issued (post-booking).
gdnOrderId	order	String	O
promotionCriteria	root	Object	O	A Promotion and discount code criteria to be passed to the retailer airline that could influence returned offers
promotionCode	promotionCriteria	String	O	Promotion code ID or number.

Response

Response Payload Example

{
   "error": null,
   "bundleResult": {
       "flightOfferRefId": "167e64888d114d2ba1a79aa8cc8d0b87",
       "flightOrderRef": null,
       "bundleOffers": [
           {
               "bundleOfferId": "5e9979be-9ecb-4916-9087-e2e6c454260a",
               "bundle": {
                   "bundleCode": null,
                   "bundleName": "VALUE PACK",
                   "bundleDescription": null,
                   "includedServices": [
                       {
                           "serviceType": "Meal",
                           "serviceName": "Non-vegetarian Value Pack meal",
                           "limitedPerPsg": "1",
                           "needSelection": true
                       },
                       {
                           "serviceType": "Seat",
                           "serviceName": "Standard seats selection",
                           "limitedPerPsg": "1",
                           "needSelection": true
                       },
                       {
                           "serviceType": "Meal",
                           "serviceName": "Water",
                           "limitedPerPsg": "2",
                           "needSelection": false
                       },
                       {
                           "serviceType": "Baggage",
                           "serviceName": "Checked baggage 20kg",
                           "limitedPerPsg": "1",
                           "needSelection": false
                       },
                       {
                           "serviceType": "Insurance",
                           "serviceName": "Bundle Travel Insurance by Tune Protect",
                           "limitedPerPsg": "1",
                           "needSelection": false
                       }
                   ]
               },
               "bundlePsgFares": [
                   {
                       "paxType": "ADT",
                       "unitPrice": {
                           "totalAmount": "41.130",
                           "currency": "USD",
                           "settlementPrices": null,
                           "baseAmount": null,
                           "taxFeeAmount": null,
                           "totalServiceFeeAmount": null,
                           "taxFeeDetails": null,
                           "serviceFeeDetails": null,
                           "currencyConversions": null,
                           "priceType": null,
                           "commissionAmount": null,
                           "totalBaseAmount": "41.130",
                           "totalTaxFeeAmount": "0.000"
                       }
                   },
                   {
                       "paxType": "CHD",
                       "unitPrice": {
                           "totalAmount": "41.130",
                           "currency": "USD",
                           "settlementPrices": null,
                           "baseAmount": null,
                           "taxFeeAmount": null,
                           "totalServiceFeeAmount": null,
                           "taxFeeDetails": null,
                           "serviceFeeDetails": null,
                           "currencyConversions": null,
                           "priceType": null,
                           "commissionAmount": null,
                           "totalBaseAmount": "41.130",
                           "totalTaxFeeAmount": "0.000"
                       }
                   }
               ],
               "eligibleTrips": {
                   "onwardTrip": {
                       "segmentSequences": [
                           1
                       ]
                   },
                   "returnTrip": null
               },
               "eligibleLeg": null,
               "bundleExtraInfo": null
           }
       ]
   }
}

Key	Parent	Type	Mandatory/Optional	Description
bundleResult	root	Object	O	Root object containing the bundle query result.
flightOfferRefId	bundleResult	String	O	Reference ID of the original flight offer associated with the bundle.
flightOrderRef	bundleResult	Object	O
supplierOrderId	flightOrderRef	String	M
gdnOrderId	flightOrderRef	String	M
bundleOffers	bundleResult	Array	M	List of available bundle offers for the flight.
bundleOfferId	bundleOffers	String	M	Unique identifier for the bundle offer. Will be used in orderCreate step
bundle	bundleOffers	Object	M
bundleName	bundle	String	M	Name of the bundle (e.g., “Flex Bundle”, “Comfort Bundle”)
bundleDescription	bundle	String	O
bundleCode	bundle	String	O	[Since v2.0]
includedServices	bundle	Array	M	List of services included in the bundle.
serviceType	includedServices	String	M	Type of service (e.g., Baggage, Meal, Seat Selection, Lounge Access).
serviceName	includedServices	String	M	Name of the specific service included.
ssrCode	includedServices	String	O	[Since v2.0]
limitedPerPsg	includedServices	String	O	Indicates whether the service is limited per passenger (e.g., “1 per passenger”).
needSelection	includedServices	Boolean	M	Indicates whether the passenger must select this service (“true”) or it is automatically included (false”)
bundlePsgFares	bundleOffers	Array	M	Fare breakdown per passenger type for the bundle.
paxType	bundlePsgFares	String	M
unitPrice	bundlePsgFares	Object	M	Price details for the bundle per passenger
currency	unitPrice	String	M
totalAmount	unitPrice	String	M	The final total amount payable by the passenger. Calculation formula: baseAmount + taxFeeAmount + serviceFeeAmount
totalBaseAmount	unitPrice	String	O
totalTaxFeeAmount	unitPrice	String	O
totalServiceFeeAmount	unitPrice	String	O
taxFeeDetails	unitPrice	Array	O
code	taxFeeDetails	String	O	The tax name
taxCode	taxFeeDetails	String	O	[Since v2.0] The tax code
amount	taxFeeDetails	String	O
type	taxFeeDetails	String	O	Enum values: AirlineTax - Standard airline taxes VAT - Value added tax Other - Other tax types
serviceFeeDetails	unitPrice	Array	O
code	serviceFeeDetails	String	O	All service fees related to flight booking - including those charged by non-airline suppliers, DerbySoft.
amount	serviceFeeDetails	String	O
type	serviceFeeDetails	String	O	Enum values: Supplier - Supplier service fee DS - DerbySoft service fee
includedInTotal	serviceFeeDetails	String	O	true - Already included in TotalAmount false - Not included in TotalAmount, requires additional payment
currencyConversions	unitPrice	Array	O	Provided when any fee requires currency conversion, contains complete conversion information.
fromCurrency	currencyConversions	String	O
toCurrency	currencyConversions	String	O
rate	currencyConversions	String	O
appliedTo	currencyConversions	String	O
referenceCode	currencyConversions	String	O	The code(under service fee details node or tax fee details) for reference which this currencyConversions applied to.
originalAmount	currencyConversions	String	O
convertedAmount	currencyConversions	String	O
settlementPrices	unitPrice	Array	O	[Since v2.0] For multi-currency, this node will return all eligible settlement currency quotations.
totalBaseAmount	settlementPrices	String	M	[Since v2.0]
totalTaxFeeAmount	settlementPrices	String	M	[Since v2.0]
taxFeeDetails	settlementPrices	Array	O	[Since v2.0]
code	taxFeeDetails	String	O	[Since v2.0] The tax name
taxCode	taxFeeDetails	String	O	[Since v2.0] The tax code
amount	taxFeeDetails	String	O	[Since v2.0]
type	taxFeeDetails	String	O	[Since v2.0] Enum values: AirlineTax - Standard airline taxes VAT - Value added tax Other - Other tax types
totalServiceFeeAmount	settlementPrices	String	O	[Since v2.0]
serviceFeeDetails	settlementPrices	Array	O	[Since v2.0]
code	serviceFeeDetails	String	O	[Since v2.0] All service fees related to flight booking - including those charged by non-airline suppliers, DerbySoft.
amount	serviceFeeDetails	String	O	[Since v2.0]
type	serviceFeeDetails	String	O	[Since v2.0] Enum values: Supplier - Supplier service fee DS - DerbySoft service fee
currency	settlementPrices	String	O	[Since v2.0]
source	settlementPrices	String	O	[Since v2.0]
exchangeRate	settlementPrices	String	O	[Since v2.0]
eligibleTrips	bundleOffers	Object	M
onwardTrip	eligibleTrips	Object	O
segmentSequences	onwardTrip	Array	M
returnTrip	eligibleTrips	Object	O
segmentSequences	returnTrip	Array	M
eligibleLeg	bundleOffers	Object	O
legSequence	eligibleLeg	String	M
error	root	Object	O

BundleAvailability

Request Payload Example

Request Payload Structure

Response

Response Payload Example