Open-jaw and multi-city searches

Send segments instead of origin, destination, departure_date and return_date when the trip is not a plain one-way or return: an open-jaw (you fly back from another airport) or a multi-city trip (three or more flights). The search type comes from the segments you send.

Each segment needs:

The same limits as a plain search apply to each date (from yesterday up to 365 days ahead).

Open-jaw

The outbound arrives at one airport; the return leaves from another.

curl https://api.fx-port.com/api/v1/get_flights \
  -H "Authorization: Bearer fxp_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "segments": [
    {
      "origin": "ALG",
      "destination": "CDG",
      "departure_date": "2026-12-15"
    },
    {
      "origin": "ORY",
      "destination": "ALG",
      "departure_date": "2026-12-22"
    }
  ],
  "cabin_class": "economy",
  "passengers": {
    "adults": 1
  }
}'

FX-Port recognises an open-jaw because the second segment is not the reverse of the first. Both sandbox suppliers answered (129 offers from Amadeus Algeria and 196 from Duffel in our test).

Response example

searchType is "OPEN_JAW" and each offer has one itinerary entry per direction. The second entry departs from ORY, not from CDG: that is the open-jaw. The example is the Duffel offer, trimmed to the airports:

{
  "success": true,
  "searchType": "OPEN_JAW",
  "suppliers": [
    {
      "success": true,
      "results": {
        "totalOffers": 196,
        "offers": [
          {
            "itinerary": [
              { "direction": "outbound", "segments": [{ "departure": { "airportCode": "ALG" }, "arrival": { "airportCode": "CDG" } }] },
              { "direction": "return", "segments": [{ "departure": { "airportCode": "ORY" }, "arrival": { "airportCode": "ALG" } }] }
            ]
          }
        ]
      }
    }
  ]
}

Multi-city

Three or more flights, in order:

curl https://api.fx-port.com/api/v1/get_flights \
  -H "Authorization: Bearer fxp_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "segments": [
    {
      "origin": "ALG",
      "destination": "CDG",
      "departure_date": "2026-12-15"
    },
    {
      "origin": "CDG",
      "destination": "MAD",
      "departure_date": "2026-12-18"
    },
    {
      "origin": "MAD",
      "destination": "ALG",
      "departure_date": "2026-12-22"
    }
  ],
  "cabin_class": "economy",
  "passengers": {
    "adults": 1
  },
  "supplier_id": "duffel_1"
}'

searchType is "MULTI_CITY". Duffel returned 568 offers in a 4.6 MB response (80 KB with Accept-Encoding: gzip). The legs of an offer are named outbound, return and then segment_3, segment_4 ...: the second leg of a multi-city offer is called return even though it is not a return, so use the order of itinerary, not the name, to follow the trip:

{
  "itinerary": [
    { "direction": "outbound", "duration": "PT2H24M", "stops": 0, "segments": [{ "departure": { "airportCode": "ALG" }, "arrival": { "airportCode": "CDG" } }] },
    { "direction": "return", "duration": "PT1H59M", "stops": 0, "segments": [{ "departure": { "airportCode": "CDG" }, "arrival": { "airportCode": "MAD" } }] },
    { "direction": "segment_3", "duration": "PT1H32M", "stops": 0, "segments": [{ "departure": { "airportCode": "MAD" }, "arrival": { "airportCode": "ALG" } }] }
  ]
}

An offer is one fare for the whole trip: price it and book it as a whole.

Notes

• A search with segments ignores origin, destination, departure_date and return_date.
• Each selected supplier receives every segment.
• To fly two separate one-way trips at two different fares, make two searches.

Related

• Search flights and Basic routes.
• Supplier selection.