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

# jinko flight-search

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

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`.                                |         |
| `--from <origin>`               | No                     | DEPRECATED: use --origin.                                                                        |         |
| `--to <destination>`            | No                     | DEPRECATED: use --destination.                                                                   |         |
| `--date <date>`                 | No                     | DEPRECATED: use --departure-date.                                                                |         |
| `--return <date>`               | No                     | DEPRECATED: use --return-date.                                                                   |         |
| `--cabin <class>`               | No                     | DEPRECATED: use --cabin-class.                                                                   |         |
| `--passengers <n>`              | No                     | DEPRECATED: use --adults.                                                                        |         |
| `--origin-type <type>`          | No                     | DEPRECATED: ignored by the public contract (no longer sent).                                     |         |
| `--destination-type <type>`     | No                     | DEPRECATED: ignored by the public contract (no longer sent).                                     |         |

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