DerbySoft GDN Seller API

TABLE OF CONTENTS

Request Payload Example

Request Payload Structure
Response
- Response Payload Example

interface retrieves available seating options, including their locations, features(window/exit..), and real-time pricing for a specific itinerary.

Version	Date	Description of Edit
V1.0	2025/10/22	Initial Commit
V1.1	2025/11.23	Added bundleOfferId parameter to support bundle seat selection in request
V1.2	2026/07/02	SeatAvailabilityRS: Added detailed price breakdown fields under seatPsgFares.
V2.0	2026/08/15	SeatAvailabilityRQ: Supported post-booking seat reassignment and flight time change seat reselection. SeatAvailabilityRS: Added seat tax breakdown with tax code Enrich seatType enumerations (EXIT, EXTRA_LEG_ROOM, etc.). Delivered full cabin seat maps with occupancy status (occupied, bookable) Supported granular passenger safety restriction flags (restrictedPaxTypes for infants, pregnant passengers, mobility limitations, etc.).

Request Details
Path	V1.0	/api/flight/connectivity/search/seatAvailability (for freshbooking) /api/flight/connectivity/order/seatAvailability (for postbooking)
Path	V1.2	/api/flight/connectivity/search/V1.2/seatAvailability (for freshbooking) /api/flight/connectivity/order/V1.2/seatAvailability (for postbooking)
Path	V2.0	/api/flight/connectivity/search/V2.0/seatAvailability (for freshbooking) /api/flight/connectivity/order/V2.0/seatAvailability (for postbooking)

Request Payload Example

{
   "offer": {
       "offerId": "bb2e32186bdb4048a9a8b02c9902fc29"
   }
}

Request Payload Structure

Key	Parent	Type	Mandatory/Optional	Description
offer	root	Object	O
offerId	offer	String	M	Use this parameter when adding services during the initial booking process. offerId should return from AirShopping endpoint.
bundleOffers	offer	Array	O
bundleOfferId	bundleOffers	String	O	The bundleOfferId parameter is required when querying seat availability specifically for seats included in a bundle purchase. Include this field only when: The seat selection is part of a bundle identified in the bundleAvailability response The bundle service has "needSelection": true for seat services
order	root	Object	O
supplierOrderId	order	String	M	Use this parameter when adding services after a ticket has been issued (post-booking). It references the existing, confirmed order
gdnOrderId	order	String	O
reassignmentSeat	order	Object	O	[Since v2.0] Required ONLY when searching for a seat reassignment
targetSupplierBookingId	reassignmentSeat	String	M	[Since v2.0] The unique instance identifier of the specific booked ancillary service
targetgdnBookingId	reassignmentSeat	String	M	[Since v2.0]
reshopOffer	order	Object	O	[Since v2.0] This is used to shopping availability seat during flight time change process
reshopOfferId	reshopOffer	String	M	[Since v2.0] The unique identifier of the flight exchange offer, which is generated and returned by the preceding orderReshop API response. This field is strictly required only when retrieving seat maps during a post-booking flight exchange flow. The system uses this ID to locate the newly selected flights, dates, and cabin configurations to render the correct seat layout. Leave this field empty or null for standard new booking flows.
reshopTransInfo	reshopOffer	String	M	[Since v2.0] The unique identifier of the flight exchange offer, which is generated and returned by the preceding orderReshop API response. This field is strictly required only when retrieving seat maps during a post-booking flight exchange flow. The system uses this ID to locate the newly selected flights, dates, and cabin configurations to render the correct seat layout. Leave this field empty or null for standard new booking flows.
tripsInfo	root	Object	O
tripKey	tripsInfo	String	M
onwardTrip	tripsInfo	Object	M
segmentInfos	onwardTrip	Array	M	segment information list
segmentSequence	segmentInfos	String	M
flightDesignator	segmentInfos	Object	M
marketingCarrier	flightDesignator	Object	M
marketingCarrierCode	marketingCarrier	String	M
marketingFlightNumber	marketingCarrier	String	M
departureInfo	segmentInfos	Object	M
departureDate	departureInfo	String	M	YYYY-MM-DD
departureTime	departureInfo	String	M	HH:MM
airportCode	departureInfo	String	M
arrivalInfo	segmentInfos	Object	M
arrivalDate	arrivalInfo	String	M	YYYY-MM-DD
arrivalTime	arrivalInfo	String	M	HH:MM
airportCode	arrivalInfo	String	M
returnTrip	tripsInfo	Object	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,
   "seatResult": {
       "flightOfferRefId": "bb2e32186bdb4048a9a8b02c9902fc29",
       "flightOrderRef": null,
       "onwardTrip": {
           "segmentSeatInfos": [
               {
                   "segmentInfo": {
                       "segmentSequence": 1,
                       "duration": null,
                       "flightDesignator": {
                           "marketingCarrier": {
                               "marketingCarrierCode": "AK",
                               "marketingCarrierName": "AK",
                               "marketingFlightNumber": "62",
                               "equipmentType": null,
                               "carbonEmission": null
                           },
                           "operatingCarrier": null
                       },
                       "departureInfo": {
                           "airportCode": "CCU",
                           "airportName": "CCU",
                           "terminal": null,
                           "departureDate": "2025-11-04",
                           "departureTime": "01:05"
                       },
                       "arrivalInfo": {
                           "airportCode": "KUL",
                           "airportName": "KUL",
                           "terminal": null,
                           "arrivalDate": "2025-11-04",
                           "arrivalTime": "07:30"
                       },
                       "stopNumber": null,
                       "stops": null
                   },
                   "seats": [
                       {
                           "serviceOfferId": "5cc14388f9aceb8baf836b8b702cb6eb",
                           "designator": "25A",
                           "deck": "Main",
                           "rowNo": "25",
                           "colNo": "A",
                           "seatTypes": [
                               "WINDOW"
                           ],
                           "seatPsgFares": [
                               {
                                   "psgType": "ADT",
                                   "unitPrice": {
                                       "totalAmount": "0.000",
                                       "currency": "USD",
                                       "settlementPrices": null
                                   },
                                   "seatSettlePrice": null
                               },
                               {
                                   "psgType": "CHD",
                                   "unitPrice": {
                                       "totalAmount": "0.000",
                                       "currency": "USD",
                                       "settlementPrices": null
                                   },
                                   "seatSettlePrice": null
                               }
                           ],
                           "seatExtraInfo": null
                       }
                   ]
               }
           ]
       }
   }
}

Key	Parent	Type	Mandatory/Optional	Description
seatResult	root	Object	O
flightOfferRefId	seatResult	String	O
flightOrderRef	seatResult	Object	O
supplierOrderId	flightOrderRef	String	M
gdnOrderId	flightOrderRef	String	O
onwardTrip	seatResult	Object	M
segmentSeatInfos	onwardTrip	Array	M
segmentInfo	segmentSeatInfos	Object	M
segmentSequence	segmentInfo	String	M
flightDesignator	segmentInfo	Object	M
marketingCarrier	flightDesignator	Object	M
marketingCarrierCode	marketingCarrier	String	M
marketingFlightNumber	marketingCarrier	String	M
departureInfo	segmentInfo	Object	M
departureDate	departureInfo	String	M	YYYY-MM-DD
departureTime	departureInfo	String	M	HH:MM
airportCode	departureInfo	String	M
arrivalInfo	segmentInfo	Object	M
arrivalDate	arrivalInfo	String	M	YYYY-MM-DD
arrivalTime	arrivalInfo	String	M	HH:MM
airportCode	arrivalInfo	String	M
seats	segmentSeatInfos	Array	M
serviceOfferId	seats	String	M	A unique identifier for this specific service offering. This ID must be provided in subsequent flow
designator	seats	String	M	Referred to as airline code
deck	seats	String	O	Indicates the level or deck of the aircraft where the seat is located. Main: for the primary cabin deck Upper: for the upper deck
rowNo	seats	String	M	Specifies the row number of the seat
colNo	seats	String	M	Specifies the column position or seat letter within the row
seatTypes	seats	Array	O	The characteristics and features of the seat. This field uses standardized codes: WINDOW AISLE EXIT MIDDLE EXTRA_LEG_ROOM HANDICAP_ACCESSIBLE: wheelchair accessible seat BASSINET: [Since v2.0] BULKHEAD: [Since v2.0] LAVATORY: [Since v2.0] WING: Over Wing [Since v2.0] RECLINE: Seats withrestricted recline (e.g., the row immediately in front of an emergency exit, where the recline angle is locked for evacuation safety). [Since v2.0] QUIET: quiet zone seat [Since v2.0] NWINDOW: Physically located next to the fuselage sidewall, but due to aircraft structure, there is no window at that exact seat [Since v2.0] WIDTH: Width seat [Since v2.0] MOVIE: has movie screen [Since v2.0] ENGINE: Near Engine [Since v2.0]
seatEligibility	seats	Object	O	[Since v2.0]
occupied	seatEligibility	Boolean	O	[Since v2.0] Indicates if the seat is already taken by another passenger True: occupied False: available
bookable	seatEligibility	Boolean	O	[Since v2.0] Indicates if the seat is selectable under the current purchase context (e.g., the specific Fare Bundle selected True: selectable False: blocked for the current context
restrictedPaxTypes	seatEligibility	Array	O	[Since v2.0] A list of passenger types or conditions that are allowed from choosing this seat (e.g., due to exit-row safety policies). UNDER_15_RESTRICTED: Restrict if the passenger's age is under 15 years old (< 15) on the date of departure. This is used for Emergency Exit Row Restrictions where passengers under 15 are prohibited from selecting emergency exit row seats due to safety requirements regarding evacuation assistance. UNDER_12_RESTRICTED: Restrict if the passenger's age is under 12 years old (< 12) on the date of departure. UNDER_10_RESTRICTED: Restrict if the passenger's age is under 10 years old (< 10) on the date of departure. INFANT_RESTRICTED: Restrict if the adult passenger is traveling with an infant (either lap-held or occupying an extra seat). This is used for Safety & Oxygen Mask Allocation where passengers with infants cannot be seated in emergency exit rows or rows with oxygen mask limitations. PREGNANT_RESTRICTED: Restrict if the passenger has a pregnancy status or related Special Service Request (SSR) flagged in the order. Under airline safety policies, pregnant passengers at any stage of pregnancy are strictly prohibited from occupying emergency exit row seats. MOBILITY_RESTRICTED: Restrict if the passenger is associated with Special Assistance SSRs (e.g., WCHR/Wheelchair, BLND/Blind, DEAF/Deaf) or has limbs in a plaster cast. Passengers with restricted mobility or physical impairments cannot assist in opening emergency doors during an evacuation and are barred from exit rows. EXTRA_SEAT_RESTRICTED: Block for standard solo passengers. Selectable only if mapped to an "EXTRA SEAT" virtual passenger in the booking. This is used for Oversized Baggage / Comfort Space where these seats are reserved exclusively for cabin baggage (such as musical instruments like CBBG) or extra space and must be paired with a primary passenger.
reassignmentSeat	seats	Object	O	[Since v2.0] will only return is node when it’s seat reassignment search
targetSupplierBookingId	reassignmentSeat	String	M	[Since v2.0] Conditional. The unique bookingId of the old booked ancillary that this new option is meant to replace/upgrade. Matches the targetBookingId sent in the request.
targetgdnBookingId	reassignmentSeat	String	M	[Since v2.0] Conditional. The unique bookingId of the old booked ancillary that this new option is meant to replace/upgrade. Matches the targetBookingId sent in the request.
seatPsgFares	seats	Array	O
psgType	seatPsgFares	String	O
unitPrice	seatPsgFares	Object	O
totalAmount	unitPrice	String	O
currency	unitPrice	String	O
totalBaseAmount	unitPrice	String	M
totalTaxFeeAmount	unitPrice	String	M
totalServiceFeeAmount	unitPrice	String	M
taxFeeDetails	unitPrice	Array	O
code	taxFeeDetails	String	O
amount	taxFeeDetails	String	O
type	taxFeeDetails	String	O
serviceFeeDetails	unitPrice	Array	O
code	serviceFeeDetails	String	O
amount	serviceFeeDetails	String	O
type	serviceFeeDetails	String	O
includedInTotal	serviceFeeDetails	String	O	true - Already included intotalAmount; false - Not included in totalAmount.
currencyConversions	unitPrice	Array	O
fromCurrency	currencyConversions	String	O
toCurrency	currencyConversions	String	O
rate	currencyConversions	String	O
appliedTo	currencyConversions	String	O
referenceCode	currencyConversions	String	O
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]
reassignmentPriceDetails	unitPrice	Object	O	[Since v2.0]
balanceDue	reassignmentPriceDetails	String	M	[Since v2.0] The actual net amount to be collected from the user out-of-pocket. Formula: DueAmount = TotalAmount - originalServiceCredit
originalServiceCredit	reassignmentPriceDetails	String	M	[Since v2.0] The financial credit value recovered and deducted from the old booked ancillary (e.g., the original value of the 30kg bag).
error	root	Object	O

SeatAvailability

Request Payload Example

Request Payload Structure

Response

Response Payload Example