> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gojinko.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Flight price advice (preview)

> Accept a flight with its current price for price advice

Use this preview to compare a supplied fare with typical fares for comparable flights and receive fixed 1-day and 3-day price forecasts. Each available forecast includes a forecasted price and estimated probabilities that the price will increase, decrease, or remain unchanged. Contact support to request access. Initial numeric coverage is one-adult, one-way, nonstop, USD; other valid inputs return a reasoned unavailable result.

<Accordion title="Tool description (what the LLM sees)" defaultOpen={false}>
  ```text theme={null}
  This tool is in preview. Contact support to request access. It accepts a flight with its current price and returns schema 3.2 price advice when data covers the request.

  The response contains fixed 1-day and 3-day price forecasts; the user does not select a wait duration. Each available forecast includes a forecasted price and estimated probabilities that the price will increase, decrease, or remain unchanged relative to current_price. price_assessment compares the supplied fare with typical prices for comparable flights. recommendation.summary is deterministic and can be displayed without an LLM.

  The current_price is the one-adult total including tax and excluding optional paid extras. Its value is an integer in minor units: {value:32000,currency:"USD",decimal_places:2} means USD 320.00. Initial numeric coverage is one-way, nonstop, USD. Other structurally valid currencies, trip types, and stop counts are accepted and return an unavailable reason when statistics do not cover them. Omit stops when the actual number of connections is unknown. This tool does not search, monitor, quote, or book flights.
  ```
</Accordion>

## Parameters

| Name | Type | Required | Description |
| - | - | - | - |
| `origin` | `string` | Yes | Uppercase three-letter IATA city code for the flight's origin. Airport codes are not mapped to cities. |
| `destination` | `string` | Yes | Uppercase three-letter IATA city code for the flight's destination; it must differ from origin. Airport codes are not mapped to cities. |
| `departure_date` | `string` | Yes | Departure date in YYYY-MM-DD format; it must be a real calendar date strictly after the current UTC date. |
| `trip_type` | `enum ("oneway" \| "roundtrip")` | Yes | Trip shape. The preview accepts oneway and roundtrip; planned initial statistics cover oneway only. |
| `stops` | `enum (0 \| 1 \| 2)` | No | Actual number of flight connections: 0 for nonstop, 1, or 2. Omit when unknown. |
| `cabin_class` | `enum ("economy" \| "premium_economy" \| "business" \| "first")` | Yes | Cabin class: economy, premium\_economy, business, or first. |
| `current_price` | `object` | Yes | One adult's total fare including tax for the supplied trip, excluding optional paid extras. |
| `current_price.value` | `integer` | Yes | One adult total fare as a positive safe integer in minor units. |
| `current_price.currency` | `string` | Yes | Supported uppercase ISO 4217 currency code. |
| `current_price.decimal_places` | `integer` | Yes | Currency minor-unit precision; it must match the currency's ISO 4217 value. |
| `user_intent` | `string` | No | The end user's current request in their own words, e.g. "help me with my travel plans". Pass it as-is when short; otherwise condense the goal and constraints into 1-2 sentences. Strip personal identifiers (names, emails, phone numbers, addresses, payment details), replace them with placeholders like "\[name]". Optional and never changes the result of the call; Jinko uses it to understand demand and improve results. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.