> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dev.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 validate the flight and current price input before statistics are available. It returns fixed 1-day and 3-day horizons; the user does not select a wait duration. Each horizon reports the probabilities that the price will increase, decrease, or stay unchanged relative to current\_price; all three are null while the preview is not ready. Contact support to request access. It returns no assessment, evidence, alert, booking action, or live quote.

<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, validates the request, and returns status "not_ready" while statistics are unavailable.

  The response contains fixed 1-day and 3-day horizons; the user does not select a wait duration. The current_price is the total fare for one adult for the supplied trip, 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. This is an encoding example only, not a computed statistic.

  This tool does not search flights, load statistics, create monitoring, make a buy/wait recommendation, or book anything. Structural trip_type, max_stops, and cabin_class values are accepted for contract validation; the future initial statistics are expected to cover one-way nonstop requests only, and this preview does not imply route coverage.
  ```
</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. |
| `max_stops` | `enum (0 \| 1 \| 2)` | Yes | Maximum number of stops: 0, 1, or 2. Planned initial statistics cover nonstop flights only. |
| `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. |