Amadeus · JSON Structure

Flight Offers Search Flight Offer Structure

FlightOffer structure from Flight Offers Search

Type: object Properties: 16 Required: 2
TravelTravel TechnologyReservationsFlightsHotelsAirlinesHospitalityTours and ActivitiesCars and TransfersDestination ContentItinerary ManagementTrip PlanningArtificial IntelligenceMarket Insights

Flight Offers Search Flight Offer Structure is a JSON Structure definition published by Amadeus, describing 16 properties, of which 2 are required. It conforms to the https://json-structure.org/draft/v0/schema meta-schema.

Properties

type id source instantTicketingRequired disablePricing nonHomogeneous oneWay paymentCardRequired lastTicketingDate lastTicketingDateTime numberOfBookableSeats itineraries price pricingOptions validatingAirlineCodes travelerPricings

Meta-schema: https://json-structure.org/draft/v0/schema

JSON Structure

Raw ↑
{
  "$schema": "https://json-structure.org/draft/v0/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-structure/flight-offers-search-flight-offer-structure.json",
  "title": "FlightOffer",
  "description": "FlightOffer structure from Flight Offers Search",
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "description": "the resource name"
    },
    "id": {
      "type": "string",
      "description": "Id of the flight offer"
    },
    "source": {
      "type": "string",
      "description": "source of the flight offer"
    },
    "instantTicketingRequired": {
      "type": "boolean",
      "description": "If true, inform that a ticketing will be required at booking step."
    },
    "disablePricing": {
      "type": "boolean",
      "description": "BOOK step ONLY - If true, allows to book a PNR without pricing. Only for the source \"GDS\""
    },
    "nonHomogeneous": {
      "type": "boolean",
      "description": "If true, upon completion of the booking, this pricing solution is expected to yield multiple records (a record contains booking information confirmed and stored, typically a Passenger Name Record (PNR), in the provider GDS or system)"
    },
    "oneWay": {
      "type": "boolean",
      "description": "If true, the flight offer can be combined with other oneWays flight-offers to complete the whole journey (one-Way combinable feature)."
    },
    "paymentCardRequired": {
      "type": "boolean",
      "description": "If true, a payment card is mandatory to book this flight offer"
    },
    "lastTicketingDate": {
      "type": "string",
      "description": "If booked on the same day as the search (with respect to timezone), this flight offer is guaranteed to be thereafter valid for ticketing until this date (included). Unspecified when it does not make sense for this flight offer (e.g. no control over ticketing once booked). YYYY-MM-DD format, e.g. 2019-06-07"
    },
    "lastTicketingDateTime": {
      "type": "string",
      "format": "date-time",
      "description": "If booked on the same day as the search (with respect to timezone), this flight offer is guaranteed to be thereafter valid for ticketing until this date/time (included). Unspecified when it does not make sense for this flight offer (e.g. no control over ticketing once booked). Information only this attribute is not used in input of pricing request. Local date and time in YYYY-MM-ddThh:mm:ss format, e.g. 2017-02-10T20:40:00"
    },
    "numberOfBookableSeats": {
      "type": "number",
      "description": "Number of seats bookable in a single request. Can not be higher than 9."
    },
    "itineraries": {
      "type": "array"
    },
    "price": {
      "type": "object",
      "description": "price information"
    },
    "pricingOptions": {
      "type": "object"
    },
    "validatingAirlineCodes": {
      "type": "array",
      "description": "This option ensures that the system will only consider offers with these airlines as validating carrier."
    },
    "travelerPricings": {
      "type": "array",
      "description": "Fare information for each traveler/segment"
    }
  },
  "required": [
    "type",
    "id"
  ]
}