Skip to main content
POST
Accept a flight with its current price for price advice
Accepts a flight with its current price and returns price advice. Available results compare the fare with typical fares for comparable flights and provide fixed 1-day and 3-day price forecasts, each with a forecasted price and estimated probabilities of an increase, decrease, or no change. Initial numeric coverage is one-adult, nonstop, USD; one-way, and round-trip with return_date; other structurally valid inputs return a reasoned unavailable result. The deterministic summary can be displayed without an LLM. The endpoint requires a verified jnk_ API key and does not search, monitor, quote, or book flights. When the platform refuses the inputs, the answer is 400 or 422 BAD_REQUEST with the platform’s sentence; a 502 is a technical failure (UPSTREAM_ERROR).

Authorizations

X-API-Key
string
header
required

Body

application/json

A flight and its current price. Trip type, the optional actual connection count, and cabin are validated as values; a valid request does not imply that statistics cover it. A round trip names its return_date.

origin
string
required
Pattern: ^[A-Z]{3}$
Example:

"NYC"

destination
string
required
Pattern: ^[A-Z]{3}$
Example:

"LAX"

departure_date
string
required
Pattern: ^\d{4}-\d{2}-\d{2}$
Example:

"2026-10-20"

trip_type
enum<string>
required
Available options:
oneway,
roundtrip
cabin_class
enum<string>
required
Available options:
economy,
premium_economy,
business,
first
current_price
object
required

One adult total fare for the supplied trip, including tax and excluding optional paid extras. Value 32000, USD, decimal_places 2 means USD 320.00.

return_date
string

Return date in YYYY-MM-DD format, a real calendar date on or after departure_date. Required when trip_type is roundtrip; must be omitted when trip_type is oneway.

Pattern: ^\d{4}-\d{2}-\d{2}$
Example:

"2026-10-27"

stops
enum<number>

Actual number of flight connections: 0 for nonstop, 1, or 2. Omit when unknown. For a round trip, 0 means nonstop on both the outbound and the inbound flight; 1 and 2 are not covered for round trips.

Available options:
0,
1,
2
intent
object

Response

Computed flight price advice or a reasoned unavailable/not-ready result

Price advice. Results may be available, partial, unavailable, or not ready; fixed 1-day and 3-day horizons are always present.

schema_version
enum<string>
required
Available options:
3.2
status
enum<string>
required
Available options:
available,
partial,
unavailable,
not_ready
reason
required
Available options:
statistics_not_ready,
future_statistics,
stale_statistics,
unsupported_currency,
unsupported_trip_type,
stops_unknown,
unsupported_stops,
route_not_covered,
insufficient_data,
horizon_not_supported,
unsafe_projected_amount,
request_cancelled,
partial_statistics,
statistics_unavailable
summary
string
required
Minimum string length: 1
context
object
required
price_assessment
object
required
wait_assessment
object
required
recommendation
object
required
live_quotes_used
enum<boolean>
required
Available options:
false