DerbySoft GDN Seller API

TABLE OF CONTENTS

Overview
Request Payload Example
Request Payload Structure
Response Payload Example
- Response Payload Example
Response Structure

Overview

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

Request Details
Path	/api/flight/connectivity/search/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 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
           }
       ]
   }
}

Response Structure

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
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.
limitedPerPsg	includedServices	String	O	Indicates whether the service is limited per passenger (e.g., “1 per passenger”).
needSelection	includedServices	String	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
baseAmount	unitPrice	String	O
taxFeeAmount	unitPrice	String	O
totalServiceFeeAmount	unitPrice	String	O
taxFeeDetails	unitPrice	Array	O
code	taxFeeDetails	String	O
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
eligibleTrips	bundleOffers	Object	M
onwardTrip	eligibleTrips	Object	O
segmentSequence	onwardTrip	Array	M
returnTrip	eligibleTrips	Object	O
segmentSequence	returnTrip	Array	M
eligibleLeg	bundleOffers	Object	O
legSequence	eligibleLeg	String	M
error	root	Object	O

BundleAvailability

Overview

Request Payload Example

Request Payload Structure

Response Payload Example

Response Payload Example

Response Structure