Skip to main content

Last updated: July 13, 2026

Overview​

This update aligned the FlightHub API documentation with the latest Swagger definitions, updated business rules, and current implementation behavior. The changes covered request and response samples, required-field rules, system support, refund and exchange flows, error codes, and passenger and document validation notes.

Key Changes​

System List​

  • Added PR - Philippine Airlines.
  • Added 9C - Spring Airlines.
  • Updated TR to TH - Scoot & Batik.
  • Added isNDC query parameter documentation for the system list endpoint.

Request and Response Samples​

  • Standardized API examples from Example Request/Response to Sample Request/Response.
  • Added missing sample requests and responses across API documentation.
  • Expanded the Book Flight sample request with complete passenger, document, contact, guest contact, membership, seat, baggage, ancillary, tour code, account code, and auto-issue fields.
  • Added sample responses for missing Exchange Ticket steps.
  • Added a sample request for Get System List.

Required Field Updates​

  • Marked system as required where applicable.
  • Marked flightValue, flightValues, seatValue, baggageValue, and ancillaryValue as required where applicable.
  • Marked bookingCode as required for Booking Management and Supplementary Information endpoints.
  • Marked passengers as required for Add Document.
  • Marked givenName and surname as required in Book Flight passenger data.

Flight Value and Ancillary Value Flow Notes​

  • Documented that Book Flight flightValues must come from Select Flight.
  • Documented that Select Flight flightValues must come from Search Flight.
  • Documented that Get SeatMap, Get Baggages, and Get Ancillaries use Search Flight flightValue before booking and Retrieve Booking flightValue after booking or ticket issuance.
  • Documented that Add SeatMap, Add Baggage, and Add Ancillary use the values returned by their corresponding Get endpoints together with bookingCode.

Search Flight Rules​

  • Added departDate validation rules for past dates, a 365-day booking window, and round-trip dates.
  • Added passenger count rule: adt + chd <= 9.
  • Added note that chd may be referred to as CNN in some airline flows.
  • Updated accompaniment rule to: Child/Infant passengers must be accompanied by adults.
  • Updated issueDate type to DateOnly for Search Flight, Select Flight, and Price Quote.

Book Flight​

  • Expanded the request schema and sample request.
  • Added guidance that flightValues must be selected values returned from Select Flight, not raw Search Flight values.
  • Added passenger document validation rules.
  • Added CHD and INF date-of-birth validation notes.

Passenger and Document Rules​

  • Updated shared PaxInfo documentation.
  • Added conditional requirements for document data.
  • Documented that dateOfBirth is required for CHD and INF passengers when applicable.
  • Applied these notes to Book Flight, Add Document, Update Passenger, Add Infant, and Update Infant.

Refund Ticket​

  • Updated Refund Ticket documentation to describe the two-step flow: calculate refund with confirm: false, then confirm with confirm: true and the returned refundValue.
  • Added refundFee to RefundDoc.
  • Updated request and response samples.

Exchange Ticket​

  • Confirmed the three-endpoint flow: exchange-search, exchange-reprice, and exchange-confirm.
  • Added FlightRequest object details and preferCabin.
  • Added response structure details and sample responses for the search and reprice steps.

Error Codes​

  • Regenerated Error Code documentation from the provided ErrorCodes.json.
  • Updated error code sections and related links.

Language Cleanup​

  • Translated remaining Vietnamese user-facing guidance to English.
  • Standardized naming and wording across affected guides.

Verification​

  • Production build completed successfully after the documentation updates.
  • Local documentation routes were checked during implementation, including Flight Search, Select Flight, Book Flight, Add Document, Refund Ticket, Exchange Ticket, and Get System List.