TABLE OF CONTENTS

Getting Started


The Flight GDN (Global Data Network) Seller API provides a unified integration point for accessing global airline content. It aggregates flight inventory from multiple Suppliers - such as airlines, B2B consolidators, and other authorized distributors - and supports a wide range of standards, incl

By providing a single, simplified API, we enable Sellers to seamlessly connect to their preferred content sources, including NDC, EDIFACT, and proprietary APIs.

Eliminate technical barriers, and reduce industry fragmentation. Our goal is to promote transparent and efficient commercial relationships between Suppliers and Sellers. 


This documentation will help you build and integrate with our API.                                        



Version Control


This section indicates the published API versions. Additionally, each individual API will include a detailed record of its version history and changes.


The table below shows the current published version of each API and the version changes.

API Name

Current Version

Version HistoryCurrent Release Change
airShopping

v2.0



v1.0: Initial public version

v 2.0: 

- Supported return POO currency and settlement currency

- Added taxCode in price breakdown.

- Added journey price splitting (onwardTrip.price, returnTrip.price).

- Added legInfos[] for stopovers (sequence, airport, duration, equipment).

- Supported leg-level carbon_emissions in leg properties.

Upgraded to v2.0. Integrated multi-currency quotation, tax code, journey price splitting, leg-level stopover details, carbon emissions



offerPrice

v2.0


v1.0: Initial public version

v2.0: 

-Added taxCode in total and passenger price breakdowns.

-Added journey price splitting (onwardTrip.price, returnTrip.price).

-Added physical legInfos[] for stopovers (sequence, airport, duration, equipment).

Upgraded to v2.0. Integrated itemized tax codes, journey price splitting, physical leg details.



bundleAvailability


v2.0


v1.0: Initial public version; 

v1.1: Added support for fresh booking with bundle products

v2.0:

-Added bundleCode

-Supported returning ssrCode for bundle included services 

-Added taxCode in unit price tax details 

Upgraded to v2.0. Returned bundleCode, bundle included service ssrCode, and itemized unit price taxCode.



seatAvailability

v2.0


v1.0: Initial public version; 

v1.1: Added support for ancillary seat availability in extended booking scenarios

v2.0:

-RQ: Supported post-booking seat reassignment and flight time change seat reselection.

-RS: Added seat  tax breakdown with tax code

-RS: Enrich seatType enumerations (EXIT, EXTRA_LEG_ROOM, etc.).

-RS: Delivered full cabin seat maps with occupancy status (occupied, bookable)

-RS: Supported granular passenger safety restriction flags (restrictedPaxTypes for infants, pregnant passengers, mobility limitations, etc.).

Upgraded to v2.0. Integrated seat reassignment workflows, flight time change seat reselection, seat attributes,full cabin occupancy rendering (occupied), and restricted passenger safety flags (restrictedPaxTypes).



serviceList

v2.0


v1.0: Initial public version; 

v1.1: Added support for ancillary service listing in post-booking scenarios

v2.0:

-RQ: Supported SSR baggage upgrade request (upgradeSSR) and flight time change ancillary reselection.

-RS: Added ancillary price tax breakdown 

-RS: Added support for Carbon Offset ancillary type.

-RS: Supported SSR upgrade 

-RS: Standardized return of airline ssrCode.

Upgraded to v2.0. Integrated SSR baggage upgrade workflows, flight time change ancillary reselection, ancillary tax breakdowns, Carbon Offset support, and standardized ssrCode
orderCreate

v2.0


v1.1: Enhanced contact information by adding city and address fields; 

v1.2: Added GST-related fields and updated request/response schema

v2.0:

-RQ:Added Secondary Contact & EmergencyContact contact type and add new Carbon Offset service type, special pax doc types (OFW, PWD, SCP), order settlement currency, and Multi-FOP methods (WALLET, BSP_CASH, CARD, etc.).

-RS: Extended full order response with physical legInfos[] (stopovers), carbon_emissions, Secondary ContactInfo &emergencyContactInfo, bundle FreeServices[] (with ssrCode), Multi-FOP payment status, and itemized taxCode.

Upgraded to v2.0. Integrated Secondary/Emergency Contacts, Carbon Offset, special pax doc types (OFW/PWD/SCP), order settlement currency, Multi-FOP payment methods, physical leg details, carbon emissions, bundle free services (ssrCode), and itemized tax codes.
confirmOrder

v2.0


v1.0: Initial public version; 

v1.1: Added support for bundle-related confirmation flow; 

v1.2: Added GST-related fields and updated response schema

v2.0:

-RQ: Supported Multi-FOP payment methods.

-RS: Aligned response schema with orderCreate RS

Upgraded to v2.0. Integrated Multi-FOP payment method selection in request, and aligned response schema with orderCreate

orderRetrieve



v2.0


v1.0: Initial public version; 

v1.1: Added support for bundle-related order details and enhanced contact information output; 

v1.2: Extended response with GST and richer modification history

v2.0: Upgraded to v2.0. Standardized schema routing and endpoint versioning to align with the  GDN API v2.0. No schema change

Upgraded to v2.0. Route and endpoint versioning aligned with global API v2.0 standards without individual schema changes.

cancelOrder

v2.0

v1.0: Initial public version

v2.0: Upgraded to v2.0. Standardized schema routing and endpoint versioning to align with the GDN API v2.0. No schema change

Upgraded to v2.0. Route and endpoint versioning aligned with global API v2.0 standards without individual schema changes.

orderReshop

v2.0

v1.0: Initial public version

v2.0

-RS: Added tax breakdown codes and tax types (taxCode, taxFeeDetail.type).

-RS: Added service fee breakdown

-RS: Added physical legInfos[] for onward/return segments with stopovers.

-RS: Integrated Ancillary Auto-Move tracking via impactedServices[] array, returning service details (ssrCode, serviceName) and impact statuses (REQUIRES_RESELECTION, FORFEITED, REFUNDABLE_DROPPED).

Upgraded to v2.0. Integrated itemized tax/service fee details, physical leg details for stopovers, and impacted ancillary status tracking (impactedServices[]) for Ancillary Auto-Move during flight changes.

orderReshopRepricev2.0

v1.0: Initial public version

v2.0

-RQ: Supported flight time change ancillary reselection  

-RS: Added tax code in tax breakdowns 

-RS:Supported flight time change ancillary reselection with auto carried ancillaries and new selected ancillary price 

-RS: Added service fee details

-RS: Supported journey price splitting for requoted offers

Upgraded to v2.0. Integrated flight change ancillary reselection , tax code display, service fee breakdowns, and journey price splitting.



orderChangev2.0

v1.0: Initial public version, including post-booking services such as change flight time, update passenger name, and refund; v1.1: Added support for bundle-related change flows; 

v1.2: Added documentsId, refundRemark, duplicatedWith, and standardized refund reason enumerations; 

v1.3: Extended response with richer modification history, including fare/fee adjustments, GST breakdown, and audit metadata

v2.0

-RQ: Supported SSR baggage/service upgrades (ssrUpgrade).

-RQ: Supported post-booking seat reassignment (seatReassignment).

-RQ: Added Multi-FOP payment methods (WALLET, CARD, BSP_CASH, etc.).

-RQ: Supported post-exchange ancillary additions and document uploads (supportingDocuments).

-RS: Aligned response schema with orderCreate RS

Upgraded to v2.0. Integrated SSR upgrade choices, seat reassignment requests, Multi-FOP payment methods, post-exchange ancillary additions, supporting document uploads, and aligned response schema with orderCreate.
refundEstimatev2.0

v1.0: Initial public version

v2.0: Upgraded to v2.0. Standardized schema routing and endpoint versioning to align with the GDN API v2.0. No schema change

Upgraded to v2.0. Route and endpoint versioning aligned with global API v2.0 standards without individual schema changes.

uploadDocumentv2.0

v2.0: Initial public version. Support document upload for refund/flight time change/modify passenger info request if necessary

Initial public v2.0 version

Fulfillment Webhook

v2.0v1.0: Initial public version for webhook notification

Initial public v1.0 version

Agency Wallet Balance Queryv2.0

v2.0: Initial public version. Support retrieve updated wallet info and balance amount

Initial public v2.0 version



VersionDateDescription of Edit
Beta

2025/09/16

Initial Commit

V1.0

2025/10/22

  1. Added support for booking ancillary products(e.g., baggage, seats, meals)
  2. Added APIs for post-booking service (e.g., change flight time, update passenger name, refund)

V1.1

2025/11/23
  1. Added support for freshbooking with bundle
  2. Enhance orderCreate contact information by adding city and address fields

V1.2

2026/03/17

  1. Added documentsId to relevant order change requests in OrderChange API
  2. new context fields (refundRemark, duplicatedWith) for refunds in OrderChange API
  3. Standardized enumeration for refund reasons to ensure data consistency in OrderChange API
V2.0

2026/08/15

Major API v2.0 Suite Release: Full suite upgrade introducing breaking schema changes, multi-currency support, physical leg & carbon tracking, full seat map interactivity, SSR upgrades, Ancillary Auto-Move.



? For the detailed feature breakdown, please refer to What's New in Flight GDN Seller API v2.0.



Environment


DerbySoft provides two environments for Sellers: Test and Production (Prod).

The Test environment mirrors all functionality of Prod. However, that Test uses mock data intended only for API testing. This data is not representative of real-world values and may differ in volume from Prod.

Environments
TestFor AirShopping and OfferPrice: https://flight-connectivity.derbysoft-test.com/api/flight/connectivity/search/*
For Order APIs: https://connectivity-apse1.fs-derbysoftsec.com
ProdFor AirShopping and OfferPrice:https://connectivity-apse1.fs-derbysoftsec.com
For Order APIs::https://connectivity.fs-derbysoftca.com

For security purpose, we use different endpoints to serve AirShopping/OfferPrice APIs and Order APIs separately



Headers


Headers
SellerCode

SELLER_TEST

Authorization

3155e78e-0420-463f-8966-f3608d0de9d0 (Sample)

*It’s provided under request

*Important: Separate keys are used in Prod for AirShopping/OfferPrice and the Order APIs.