The offer object

Search, details and change-options all return the same offer model, whichever airline or GDS it came from. Offers carry IATA codes only; names come once per response in the dictionaries block. Fields with no value are omitted from the JSON rather than sent as null: appliedFareBrand, leavingOfferId, returningOfferId, terminal, layoverMinutes and aircraft.

Offer

string (uuid)

Pass this as proposalId or flightProposalId in later calls.

string

OneWay or RoundTrip.

string

Economy, PremiumEconomy, Business or First.

boolean

integer

Seats left at this fare, as the provider reports it. 9 means 9 or more.

boolean

Call fare-brands only when true.

boolean

true when the offer can be booked with holdOnly. See On-hold bookings.

string

Present after change-options: the brand code now stored on this offer.

object

Show properties

string

Currency of every amount in this block.

number

Total for all passengers, rounded to 2 decimals. Show this one.

number

Base fare total.

number

Tax total.

number

Your agency commission, included in total. For your accounting.

object[]

One entry per passenger type you searched for: passengerType, count, baseFare and taxes (per passenger), total (per passenger × count), fareType.

Journey[]

One journey for OneWay. Two for RoundTrip: outbound first, then inbound.

string (uuid)

Outbound half of a packed round trip. Present after details.

string (uuid)

Return half of a packed round trip. Present after details.

Journey

object

iataCode.

object

iataCode.

string

Local airport time, yyyy-MM-ddTHH:mm:ss, no UTC offset.

string

Local airport time, no UTC offset.

integer

Segment[]

The flights that make up this journey.

Segment

string

IATA airline code.

string

IATA airline code.

string

object

iataCode, plus terminal when known.

object

iataCode, plus terminal when known.

string

Local airport time, no UTC offset.

string

Local airport time, no UTC offset.

integer

Connection time before the next segment. Omitted on the last segment of a journey.

string

Aircraft code, for example 738.

string

Reservation booking designator (RBD), for example Y.

integer

object

Keyed by passenger type (adult, child, infant), only the types you searched for. Each has checked and cabin allowances. See Baggage.

Baggage

Allowances follow the Amadeus and IATA NDC convention for included bags.

Case	Shape	Show
Piece concept	`{ "quantity": 2, "weight": 23, "weightUnit": "KG" }` or `{ "quantity": 1 }`	2 × 23 kg, or 1 bag
Weight concept	`{ "weight": 30, "weightUnit": "KG" }`	30 kg total
Nothing included	`{ "quantity": 0 }`	No bags included
Not reported	`checked` or `cabin` key omitted	”Contact the airline”, never “no baggage”

weightUnit is KG or LB.

Dictionaries

Every response that carries offers (search, details, change-options) carries one dictionaries block. It holds English names for every carrier and airport code used in those offers, so you can render a results page without your own IATA reference data.

{
  "carriers": { "FZ": "flydubai", "IA": "Iraqi Airways" },
  "airports": {
    "BGW": { "name": "Baghdad International", "city": "Baghdad", "country": "IQ" },
    "DXB": { "name": "Dubai International", "city": "Dubai", "country": "AE" }
  }
}

airports[].country is ISO 3166-1 alpha-2, such as IQ. It’s omitted for an airport that isn’t in our catalogue, when the name comes from the airline instead.
A code can occasionally be missing when no source reported a name. Always fall back to showing the code.

Full example

{
  "offerId": "8d0e3b6a-2f41-4b8e-b1c9-5d6e7f8a9b0c",
  "tripType": "RoundTrip",
  "cabinClass": "Economy",
  "isCharter": false,
  "seatsRemaining": 5,
  "hasFareBrands": true,
  "supportsOnHold": false,
  "price": {
    "currency": "USD",
    "total": 436.00,
    "baseFare": 360.00,
    "taxes": 76.00,
    "commission": 12.00,
    "breakdown": [
      { "passengerType": "Adult", "count": 1, "baseFare": 360.00, "taxes": 76.00, "total": 436.00, "fareType": "Published" }
    ]
  },
  "journeys": [
    {
      "origin": { "iataCode": "BGW" },
      "destination": { "iataCode": "DXB" },
      "departure": "2026-12-07T03:00:00",
      "arrival": "2026-12-07T05:00:00",
      "durationMinutes": 120,
      "stops": 0,
      "segments": [
        {
          "marketingCarrier": "IA",
          "operatingCarrier": "IA",
          "flightNumber": "4313",
          "origin": { "iataCode": "BGW", "terminal": "A" },
          "destination": { "iataCode": "DXB", "terminal": "1" },
          "departure": "2026-12-07T03:00:00",
          "arrival": "2026-12-07T05:00:00",
          "durationMinutes": 120,
          "aircraft": "738",
          "cabinClass": "Economy",
          "bookingClass": "Y",
          "seatsAvailable": 5,
          "baggage": {
            "adult": {
              "checked": { "quantity": 1, "weight": 23, "weightUnit": "KG" },
              "cabin": { "quantity": 1, "weight": 7, "weightUnit": "KG" }
            }
          }
        }
      ]
    },
    { "...": "inbound journey, same shape" }
  ]
}

Get started

Guides

Reference

API endpoints

Offer

Journey

Segment

Baggage

Dictionaries

Full example

​Offer

​Journey

​Segment

​Baggage

​Dictionaries

​Full example

Offer

Journey

Segment

Baggage

Dictionaries

Full example