Cookie

We use cookies and similar technologies. By clicking OK you agree to this. Learn more

AQC

Amadeus Quick Connect (AQC) Flight Order Retrieve API Integration for Travel OTAs and Agencies


Introduction

In contemporary airline retail, the process of creating a booking is merely the starting point. Travel agencies need to be able to access the latest information about booking status and data on a constant basis in order to support customer dashboards, servicing, and post-booking functionality.

This is where the Amadeus Quick Connect Order Retrieve API system comes in.

The Flight Order Retrieve API is a crucial part of the Amadeus flight booking API system because it allows users to have a real time perspective of an existing booking. For travel OTAs, agencies, CTOs, and developers working on GDS API integration, this API endpoint is a must-have for developing a robust and scalable booking management system.

What is This API Used For?

The Flight Order Retrieve API (also referred to as Flight Order Get) is a read-only endpoint that returns the full and latest state of a flight order created through the Amadeus AQC API integration workflow.

Think of it as your single source of truth after booking creation.

Primary Use Cases

For a Flight booking API for OTA platforms, this API is generally used to:

  • Display booking details in customer dashboards
  • Verify booking confirmation before ticketing
  • Perform post-booking validation
  • Audit pricing and commissions
  • Reconcile ancillary purchases (seats, baggage, meals)
  • Check ticket issuance status

Because the response reflects the current live state, it can safely be called multiple times throughout the booking lifecycle based on the use case.

What the API Returns

The API provides a comprehensive booking snapshot, including:

  • Passenger and contact information
  • Flight itineraries and segment status
  • Confirmed pricing and taxes
  • Commission data (FM element)
  • Ticketing authorization status
  • Issued documents (ETICKET / EMD when available)
  • Ancillary services such as seats and baggage
  • Airline and GDS record locators

For OTAs or travel platforms running at a large scale, this endpoint is essential for maintaining data consistency across systems.

Sample Request and Response

Sample Request

GET /v1/booking/flight-orders/eJzTd9ePcgmLcPYEAAvQAn4

Authorization: Bearer {access_token}

Important notes:

  • No request body required
  • Must include valid OAuth token
  • Endpoint is idempotent

Sample Response

1{
2 "data": {
3 "id": "eJzTd9ePKIOLcPYEAAvQAn4",
4 "associatedRecords": [
5 {
6 "reference": "ZDVXCI",
7 "originSystemCode": "GDS"
8 }
9 ],
10 "flightOffers": [
11 {
12 "lastTicketingDate": "2026-12-17",
13 "itineraries": [
14 {
15 "segments": [
16 {
17 "bookingStatus": "CONFIRMED",
18 "segmentType": "ACTIVE",
19 "isFlown": false
20 }
21 ]
22 }
23 ],
24 "price": {
25 "grandTotal": "829.96",
26 "currency": "USD"
27 }
28 }
29 ],
30 "ticketingAgreement": {
31 "option": "CONFIRM"
32 }
33 }
34}
35

How to Determine Booking Confirmation

For production-grade GDS API integration, use this authoritative logic:

Booking is CONFIRMED only if:

  • All segments -> bookingStatus=CONFIRMED
  • All segments -> segmentType=ACTIVE
  • ticketingAgreement.option=CONFIRM
  • Valid PNR exists in associatedRecords

Do not rely on pricing or traveler data for confirmation.

When Tickets Are Issued

After ticketing, the response will include:

data -> tickets[]

Look for:

  • ETICKET -> main flight ticket
  • EMD -> seats or baggage

Common Integration Challenges

Even experienced teams encounter issues when implementing the Amadeus AQC API integration. Below are the most frequent problems - and how to avoid them.


1. Incorrect Booking Confirmation Logic

Problem

Many systems incorrectly assume:

  • Price present = confirmed
  • PNR present = confirmed

Both are wrong.

Correct approach

Always validate:

  • Segment bookingStatus
  • segmentType
  • ticketingAgreement

This is critical for OTA reliability.

2. Not Persisting Full Response

Problem

Some teams only store partial data.

This leads to:

  • Lost ancillary information
  • Reconciliation failures
  • Customer support gaps

Best practice

Always persist the complete raw response after:

  • Order creation
  • Commission update
  • Ticket issuance

3. Mishandling Traveler and Segment Mapping

Problem

Hard-coding traveler or segment indexes.

This breaks when:

  • Multiple passengers
  • Multi-city itineraries
  • Reissues

Solution

Always dynamically map:

  • travelerId
  • segmentId

Never rely on array position.

4. Immediate Ticketing Assumption

Reality

In the Amadeus flight booking API, booking is not equal to ticketed.

States differ:

  • CONFIRMED -> booking held
  • TICKETED -> document issued
  • FLOWN -> travel completed

Your OTA UI must reflect this correctly.

Best Practices for Production OTAs

If you are building a serious Flight booking API for OTA platform, follow these proven practices.

Architecture Recommendations

Treat Flight Order Retrieve as an authoritative source

  • Store full payload snapshots
  • Normalize to the internal booking model
  • Build idempotent retrieval jobs
  • Implement retry with exponential backoff
  • Log all airline references

Conclusion

The Flight Order Retrieve API is one of the most critical endpoints in the Amadeus Quick Connect API ecosystem. While it does not create or modify bookings, it provides the single most reliable view of booking truth across the entire lifecycle.

For modern travel platforms, success depends on:

  • Accurate booking state detection
  • Proper ancillary handling
  • Robust OAuth token management
  • Correct traveler and segment mapping
  • Full payload persistence

When implemented correctly, this API becomes the backbone of post-booking automation, customer servicing, and operational reliability.

For OTAs and agencies pursuing enterprise-grade GDS API integration, mastering this endpoint is non-negotiable.

Planning to integrate Amadeus Quick Connect (AQC) APIs into your travel platform? Our experienced Amadeus API integration experts help you implement secure authentication, flight search, pricing, booking, and ticketing workflows end to end. Contact us today to accelerate your Amadeus integration.

0

FAQs

Have a Question?

The Flight Order Retrieve API Flight API is used to retrieve the status and details of an existing booking that has been created through the Amadeus Quick Connect API Flight API. This is the single source of truth for all post-booking activities in the OTA systems.

A booking is confirmed only when all segments have bookingStatus=CONFIRMED, segmentType=ACTIVE, ticketing agreement is CONFIRM, and a valid PNR exists. Never use price or passenger information.

No. This is a read-only API. Only booking information is retrieved. Ticketing is done through the Flight Order Issue API. After ticketing, ETICKET and EMD information is provided in the response

This ensures that the OTAs are always updated on the latest status of the booking, ancillary sales, and ticket status.