Skip to main content
POST
/
v1
/
flight_calendar
Search flights between a known origin and destination for flexible dates
curl --request POST \
  --url https://api.example.com/v1/flight_calendar \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "origins": [
    "NYC"
  ],
  "destinations": [
    "PAR"
  ],
  "trip_type": "roundtrip",
  "departure_date_ranges": [
    {
      "start": "2026-09-01T00:00:00.000Z",
      "end": "2026-09-30T00:00:00.000Z"
    }
  ],
  "stay_days": 7,
  "cabin_class": "economy",
  "adults": 1,
  "currency": "USD"
}
'
{
  "itineraries": [
    {
      "id": "itin_9f3b2a17",
      "origin": {
        "code": "JFK",
        "name": "New York John F. Kennedy"
      },
      "destination": {
        "code": "CDG",
        "name": "Paris Charles de Gaulle"
      },
      "total": {
        "value": 412.5,
        "currency": "USD",
        "decimal_places": 2
      },
      "cabin_class": "economy"
    }
  ],
  "next_page_token": "eyJvZmZzZXQiOjIwfQ=="
}
Find priced itineraries between a known origin and destination using cached results, ideal when the user is flexible on dates. It answers questions like “cheapest week to fly Paris to Barcelona in June” or “best Friday to Sunday options from JFK to LAX next month”. Each result includes an offer token you can pass into a live price check or directly into a trip.

Authorizations

​
X-API-Key
string
header
required

Body

application/json
​
origins
string[]
required
Minimum array length: 1
Example:
["NYC"]
​
trip_type
enum<string>
required
Available options:
oneway,
roundtrip
Example:

"roundtrip"

​
destinations
string[]
Example:
["PAR"]
​
origin_type
enum<string>
default:city
Available options:
city,
airport
​
destination_type
enum<string>
default:city
Available options:
city,
airport
​
departure_dates
string[]
Pattern: ^\d{4}-\d{2}-\d{2}$
Example:
["2026-07-15T00:00:00.000Z"]
​
departure_date_ranges
object[]
​
return_dates
string[]
Pattern: ^\d{4}-\d{2}-\d{2}$
Example:
["2026-07-22T00:00:00.000Z"]
​
return_date_ranges
object[]
​
stay_days
integer
Required range: x > 0
Example:

7

​
stay_days_range
object
​
cabin_class
enum<string>
Available options:
economy,
premium_economy,
business,
first
Example:

"economy"

​
direct_only
boolean
Example:

false

​
adults
integer
Required range: x >= 0
Example:

1

​
children
integer
Required range: x >= 0
​
infants_in_lap
integer
Required range: x >= 0
​
infants_in_seat
integer
Required range: x >= 0
​
youth
integer
Required range: x >= 0
​
student
integer
Required range: x >= 0
​
ages
integer[]
Required range: x >= 0
​
residency_country
string
Required string length: 2
​
max_total
number
Required range: x > 0
Example:

800

​
currency
string
Example:

"USD"

​
locale
string
Example:

"en-US"

​
limit
integer
default:20
Required range: 1 <= x <= 100
​
offset
integer
default:0
Required range: x >= 0
​
sort_by
enum<string>
default:lowest
Available options:
lowest,
recommendation

Response

Matching itineraries

​
itineraries
object[]
required
​
next_page_token
string
Example:

"eyJvZmZzZXQiOjIwfQ=="