> ## 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.

# jinko flight-search

> Get live flight pricing, search by route, or re-price a known offer

<Note>
  **Prices in this command's output are integers in minor units.** Money objects
  carry `decimal_places` — divide by `10 ** decimal_places` to display
  (`{ "value": 15977, "decimal_places": 2 }` is **159.77**, not 15,977). See
  [Money & prices](/concepts/money).
</Note>

Fetch live, bookable pricing for a specific route and date pair. Use it once the user has settled on exact travel dates, for example "Paris to New York departing June 1 returning June 8 in economy". It also reprices an offer surfaced earlier by the calendar or destination tools so you can confirm availability before adding it to a trip.

## Usage

```bash theme={null}
jinko flight-search [options]
```

## Options

| Flag                            | Required              | Description                                                                                                                                                               | Default |
| ------------------------------- | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- |
| `--origin <code>`               | Yes, search mode      | origin IATA code (e.g. PAR for city, JFK for airport). JSON: `origin`.                                                                                                    |         |
| `--destination <code>`          | Yes, search mode      | destination IATA code (e.g. NYC for city, LAX for airport). JSON: `destination`.                                                                                          |         |
| `--departure-date <date>`       | Yes, search mode      | departure date (YYYY-MM-DD). JSON: `departure_date`.                                                                                                                      |         |
| `--return-date <date>`          | No                    | return date for round-trip (YYYY-MM-DD). JSON: `return_date`.                                                                                                             |         |
| `--cabin-class <class>`         | No                    | cabin class: economy, premium\_economy, business, first (default: economy). JSON: `cabin_class`.                                                                          |         |
| `--adults <n>`                  | No                    | number of adult passengers (default: 1). JSON: `adults`.                                                                                                                  |         |
| `--direct-only`                 | No                    | only show direct flights. JSON: `direct_only`.                                                                                                                            |         |
| `--max-price <amount>`          | No                    | maximum price filter. JSON: `max_price`.                                                                                                                                  |         |
| `--include-carriers <codes...>` | No                    | include only these IATA 2-letter carrier codes (e.g. AF KL). JSON: `include_carriers`.                                                                                    |         |
| `--exclude-carriers <codes...>` | No                    | exclude these IATA 2-letter carrier codes (e.g. FR U2). JSON: `exclude_carriers`.                                                                                         |         |
| `--limit <n>`                   | No                    | max results to return (1-100, default 20). Search mode only. JSON: `limit`.                                                                                               |         |
| `--offer-token <token>`         | Yes, price-check mode | price-check a specific offer (live pricing). JSON: `offer_token`.                                                                                                         |         |
| `--user-intent <text>`          | No                    | the end user's request in their own words, forwarded to Jinko for observability and relevance (avoid PII). Env fallback: JINKO\_USER\_INTENT. JSON: `intent.user_intent`. |         |

## Examples

```bash theme={null}
# Price-check a discovery offer
jinko flight-search --offer-token "$OFFER_TOKEN" --format json | jq '.fares[0]'

# Live search by route
jinko flight-search --origin CDG --destination JFK --departure-date 2026-06-15 --return-date 2026-06-22 \
  --adults 2 --cabin-class economy --format json
```