About GDN (Global Data Network) Seller API
Modified on: 2026-10-13 11:23
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 History | Current 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. |
| orderReshopReprice | v2.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. |
| orderChange | v2.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. |
| refundEstimate | 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. |
| uploadDocument | v2.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.0 | v1.0: Initial public version for webhook notification | Initial public v1.0 version |
| Agency Wallet Balance Query | v2.0 | v2.0: Initial public version. Support retrieve updated wallet info and balance amount | Initial public v2.0 version |
| Version | Date | Description of Edit |
|---|---|---|
| Beta | 2025/09/16 | Initial Commit |
V1.0 | 2025/10/22 |
|
V1.1 | 2025/11/23 |
|
V1.2 | 2026/03/17 |
|
| 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 | |
|---|---|
| Test | For AirShopping and OfferPrice: https://flight-connectivity.derbysoft-test.com/api/flight/connectivity/search/* |
| For Order APIs: https://connectivity-apse1.fs-derbysoftsec.com | |
| Prod | For 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. | |
Did you find it helpful? Yes No
Send feedback