GET /lowfaresearch

Provides the lowest fares and routing possibilities for a given origin and destination and a given inbound- and outbound date range.

Currently the API only returns itineraries that are sold on klm.com.

RESOURCE

GET /lowfaresearch/

QUERY PARAMETERS

RESPONSE PARAMETERS

SAMPLE REQUEST

GET https://api.airfranceklm.com/travel/Metasearch/lowfaresearch/QO/AMS/BCN/2017-07-20/2017-07-27?cabinClass=economy&numberOfAdults=2&maxConnections=3

SAMPLE RESPONSE

{
  "Success": {},
  "Errors": null,
  "Warnings": null,
  "KLM_MetaSearchParty": "QO",
  "PricedItineraries": [
    {
      "DeeplinkURL": "https://www.klm.com/travel/nl_en/apps/ebt/calendar.htm?application=EBT7&country=nl&language=en&numberOfAdults=2&numberOfChildren=0&numberOfInfants=0&msp=Operations+Research+(ITCDOR)&mp=QO&dev=5&cur=EUR&tp=423.88&tf=332.00&tt=81.88&ts=10.00&cabinClass=M&trip=AMS:20170720@1655:KL1675:Q>BCN-BCN:20170727@1955:KL1676:R>AMS&ref=MS,QO,cur=,tpcur=EUR,metascur=,fb=QSRNL.RSRNL,fee=10.00,oper=KL..KL,srv=873",
      "AirItinerary": {
        "OriginDestinationOptions": [
          {
            "FlightSegment": [
              {
                "FlightNumber": "KL1675",
                "DepartureAirport": {
                  "LocationCode": "AMS",
                  "Terminal": ""
                },
                "ArrivalAirport": {
                  "LocationCode": "BCN",
                  "Terminal": "Terminal 1"
                },
                "OperatingAirline": {
                  "Code": "KL",
                  "Value": "KLM Royal Dutch Airlines"
                },
                "Equipment": [
                  {
                    "AirEquipType": "73H",
                    "Value": "Boeing 737-800 (winglets) Passenger"
                  }
                ],
                "DepartureDateTime": "2017-07-20T16:55:00",
                "ArrivalDateTime": "2017-07-20T19:05:00",
                "StopQuantity": "0"
              }
            ]
          },
          {
            "FlightSegment": [
              {
                "FlightNumber": "KL1676",
                "DepartureAirport": {
                  "LocationCode": "BCN",
                  "Terminal": "Terminal 1"
                },
                "ArrivalAirport": {
                  "LocationCode": "AMS",
                  "Terminal": ""
                },
                "OperatingAirline": {
                  "Code": "KL",
                  "Value": "KLM Royal Dutch Airlines"
                },
                "Equipment": [
                  {
                    "AirEquipType": "73H",
                    "Value": "Boeing 737-800 (winglets) Passenger"
                  }
                ],
                "DepartureDateTime": "2017-07-27T19:55:00",
                "ArrivalDateTime": "2017-07-27T22:10:00",
                "StopQuantity": "0"
              }
            ]
          }
        ]
      },
      "AirItineraryPricingInfo": {
        "ItinTotalFare": [
          {
            "BaseFare": {
              "Amount": 166.00,
              "CurrencyCode": "EUR"
            },
            "Taxes": [
              {
                "Amount": 40.94,
                "CurrencyCode": "EUR"
              }
            ],
            "Fees": [
              {
                "Amount": 5.00,
                "CurrencyCode": "EUR",
                "Value": "Booking Fee"
              }
            ],
            "TotalFare": {
              "Amount": 211.94,
              "CurrencyCode": "EUR"
            }
          }
        ],
        "FareInfos": [
          {
            "FareReference": [
              {
                "Value": "QSRNL"
              }
            ]
          },
          {
            "FareReference": [
              {
                "Value": "RSRNL"
              }
            ]
          }
        ],
      }
    },
    {
      "DeeplinkURL": "https://www.klm.com/travel/nl_en/apps/ebt/calendar.htm?application=EBT7&country=nl&language=en&numberOfAdults=2&numberOfChildren=0&numberOfInfants=0&msp=Operations+Research+(ITCDOR)&mp=QO&dev=5&cur=EUR&tp=423.88&tf=332.00&tt=81.88&ts=10.00&cabinClass=M&trip=AMS:20170720@0810:KL1665:Q>BCN-BCN:20170727@1955:KL1676:R>AMS&ref=MS,QO,cur=,tpcur=EUR,metascur=,fb=QSRNL.RSRNL,fee=10.00,oper=KL..KL,srv=873",
      "AirItinerary": {
        "OriginDestinationOptions": [
          {
            "FlightSegment": [
              {
                "FlightNumber": "KL1665",
                "DepartureAirport": {
                  "LocationCode": "AMS",
                  "Terminal": ""
                },
                "ArrivalAirport": {
                  "LocationCode": "BCN",
                  "Terminal": "Terminal 1"
                },
                "OperatingAirline": {
                  "Code": "KL",
                  "Value": "KLM Royal Dutch Airlines"
                },
                "Equipment": [
                  {
                    "AirEquipType": "73H",
                    "Value": "Boeing 737-800 (winglets) Passenger"
                  }
                ],
                "DepartureDateTime": "2017-07-20T08:10:00",
                "ArrivalDateTime": "2017-07-20T10:20:00",
                "StopQuantity": "0"
              }
            ]
          },
          {
            "FlightSegment": [
              {
                "FlightNumber": "KL1676",
                "DepartureAirport": {
                  "LocationCode": "BCN",
                  "Terminal": "Terminal 1"
                },
                "ArrivalAirport": {
                  "LocationCode": "AMS",
                  "Terminal": ""
                },
                "OperatingAirline": {
                  "Code": "KL",
                  "Value": "KLM Royal Dutch Airlines"
                },
                "Equipment": [
                  {
                    "AirEquipType": "73H",
                    "Value": "Boeing 737-800 (winglets) Passenger"
                  }
                ],
                "DepartureDateTime": "2017-07-27T19:55:00",
                "ArrivalDateTime": "2017-07-27T22:10:00",
                "StopQuantity": "0"
              }
            ]
          }
        ]
      },
      "AirItineraryPricingInfo": {
        "ItinTotalFare": [
          {
            "BaseFare": {
              "Amount": 166.00,
              "CurrencyCode": "EUR"
            },
            "Taxes": [
              {
                "Amount": 40.94,
                "CurrencyCode": "EUR"
              }
            ],
            "Fees": [
              {
                "Amount": 5.00,
                "CurrencyCode": "EUR",
                "Value": "Booking Fee"
              }
            ],
            "TotalFare": {
              "Amount": 211.94,
              "CurrencyCode": "EUR"
            }
          }
        ],
        "FareInfos": [
          {
            "FareReference": [
              {
                "Value": "QSRNL"
              }
            ]
          },
          {
            "FareReference": [
              {
                "Value": "RSRNL"
              }
            ]
          }
        ],
      }
    }

[...]

  ],
  "TimeStamp": "2017-06-09T07:05:58",
  "Version": 2.0
}

ERROR CODES

SAMPLE ERROR RESPONSE

{
  "Success": null,
  "Errors": [
    {
      "Type": "1",
      "ShortText": "Error in request: origin not bookable/unknown.",
      "Code": "909"
    }
  ],
  "Warnings": null,
  "KLM_MetaSearchParty": "QO",
  "PricedItineraries": null,
  "Version": 1.0
}