Ignav

Cheapest Flight Dates API

Find the lowest fare for every departure date in a window of up to 31 days. Pick a date, then run the same request as a one-way or round-trip search to get bookable itineraries and booking links.

POST/api/fares/cheapest-dates

Request body

Accepts all one-way parameters except departure_date, airlines_include, airlines_exclude and allow_self_transfer, plus:

ParameterTypeRequiredDescription
departure_date_rangeobjectYesInclusive start and end departure dates (YYYY-MM-DD), spanning 1–31 days. Start cannot be before today at the origin.
stay_daysintegerNoOmit or null for one-way fares. For round trips, return this many days (0–365) after each departure.
return_time_rangeobjectNoFilter return flights by hour, as in round-trip search. Requires stay_days.

Every shared field means the same thing as in exact search, so prices reflect your passengers, cabin, stops, bags, time windows and maximum price.

One-way month

Open Playground
curl -X POST "https://ignav.com/api/fares/cheapest-dates" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"origin":"NYC","destination":"LON","departure_date_range":{"start":"2026-11-18","end":"2026-12-18"}}'

Seven-day round trip, two adults, nonstop

Open Playground
curl -X POST "https://ignav.com/api/fares/cheapest-dates" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"origin":"NYC","destination":"LON","departure_date_range":{"start":"2026-11-18","end":"2026-12-18"},"stay_days":7,"adults":2,"max_stops":0,"market":"GB"}'

Response

The response has one entry in dates for every requested departure date, in ascending order. Round trips also include return_date.

Illustrative response, shortened to two dates
{
  "origin": "NYC",
  "destination": "LON",
  "dates": [
    {
      "departure_date": "2026-11-18",
      "return_date": "2026-11-25",
      "price": {
        "amount": 1178,
        "currency": "GBP",
        "status": "unverified"
      }
    },
    {
      "departure_date": "2026-11-19",
      "return_date": "2026-11-26",
      "price": null
    }
  ],
  "observed_at": "2026-10-18T12:00:00Z"
}

price is the lowest qualifying fare for the whole trip and the whole party, in the market's currency, including required taxes and fees. It is null when no qualifying fare was found for that date. Prices are unverified and can change; exact search may return a different price.

From dates to booking

Reuse the same fields in a one-way search, replacing departure_date_range with the chosen departure_date. For round trips, use round-trip search and replace stay_days with that date's return_date. Choose an itinerary and pass its ignav_id to booking-links.

curl -X POST "https://ignav.com/api/fares/round-trip" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"origin":"NYC","destination":"LON","departure_date":"2026-11-18","return_date":"2026-11-25","adults":2,"max_stops":0,"market":"GB"}'

Each successful cheapest-dates response counts as one request, however many dates it covers. Exact searches and booking-link requests are billed separately.

Related docs