> ## 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-award-search (preview)

> Award prices in miles or points across airline loyalty programs

This command is in preview: it is not yet stable, and its options and output may change. Contact support to request access. It returns award prices only: it creates no offer, quote or booking, and its results cannot be added to a trip; an award ticket is booked with the loyalty program itself. It checks the award seats airline loyalty programs offer on one route and date, one way or round trip, and prices each in miles per traveler plus taxes in the program's own currency. All 17 programs are searched unless --programs names some. Each search covers one departure airport and one arrival airport. On a round trip each fare is the outbound plus the return, with each direction's price beside it. status partial means some programs were still being checked: run the command again to get their prices.

## Usage

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

## Options

| Flag | Required | Description | Default |
| - | - | - | - |
| `--origin <code>` | Yes | departure airport, 3-letter IATA airport code. JSON: `origin`. | |
| `--destination <code>` | Yes | arrival airport, 3-letter IATA airport code. JSON: `destination`. | |
| `--departure-date <date>` | Yes | outbound date (YYYY-MM-DD). JSON: `departure_date`. | |
| `--trip-type <type>` | Yes | oneway or roundtrip; roundtrip needs --return-date. JSON: `trip_type`. | |
| `--return-date <date>` | No | return date (YYYY-MM-DD), round trips only. JSON: `return_date`. | |
| `--cabin-class <class>` | No | economy, premium\_economy, business or first; omit for every cabin. JSON: `cabin_class`. | |
| `--adults <n>` | No | travelers, 1-9 (default 1): every fare has at least this many award seats. JSON: `adults`. | |
| `--max-stops <n>` | No | maximum stops in each direction: 0, 1 or 2. JSON: `max_stops`. | |
| `--include-carriers <codes...>` | No | keep only itineraries whose every segment is marketed by these IATA carriers. JSON: `include_carriers`. | |
| `--exclude-carriers <codes...>` | No | drop itineraries with a segment marketed by these IATA carriers. JSON: `exclude_carriers`. | |
| `--single-carrier-only` | No | keep only itineraries marketed end-to-end by one carrier. JSON: `single_carrier_only`. | |
| `--via-airports <codes...>` | No | keep only itineraries that connect at one of these airports; nonstops are kept. JSON: `via_airports`. | |
| `--exclude-via-airports <codes...>` | No | drop itineraries that connect at any of these airports. JSON: `exclude_via_airports`. | |
| `--aircraft-types <codes...>` | No | keep only itineraries flown on these IATA equipment codes (e.g. 77W 789). JSON: `aircraft_types`. | |
| `--departure-time-range <window>` | No | outbound local departure time-of-day, HH:MM-HH:MM (either bound may be omitted). JSON: `departure_time_range`. | |
| `--arrival-time-range <window>` | No | outbound local arrival time-of-day, HH:MM-HH:MM. JSON: `arrival_time_range`. | |
| `--return-departure-time-range <window>` | No | return local departure time-of-day, HH:MM-HH:MM (round trips only). JSON: `return_departure_time_range`. | |
| `--return-arrival-time-range <window>` | No | return local arrival time-of-day, HH:MM-HH:MM (round trips only). JSON: `return_arrival_time_range`. | |
| `--connection-time-min-minutes <n>` | No | shortest acceptable connection, in minutes. JSON: `connection_time_min_minutes`. | |
| `--connection-time-max-minutes <n>` | No | longest acceptable connection, in minutes. JSON: `connection_time_max_minutes`. | |
| `--max-total-duration-minutes <n>` | No | longest journey time in each direction, in minutes. JSON: `max_total_duration_minutes`. | |
| `--same-connection-airport-only` | No | keep only itineraries whose connections leave from the airport they arrived at. JSON: `same_connection_airport_only`. | |
| `--limit <n>` | No | flights returned, 1-100 (default 50); `total` counts every match. JSON: `limit`. | |
| `--programs <codes...>` | No | loyalty programs to search, by code: aadvantage, atmos\_rewards, skymiles, flying\_blue, flying\_club, trueblue, qantas\_frequent\_flyer, eurobonus, miles\_and\_smiles, mileageplus, velocity, etihad\_guest, finnair\_plus, aeromexico\_rewards, azul\_fidelidade, smiles\_br, smiles\_ar. Omit for all 17. JSON: `programs`. | |
| `--max-miles <n>` | No | most miles per traveler; on a round trip, outbound plus return. JSON: `max_miles`. | |
| `--saver-only` | No | keep only saver-level awards; programs without a saver level are not affected. JSON: `saver_only`. | |
| `--max-mixed-cabin-share <share>` | No | largest share of flying time (0 to 1) allowed in a lower cabin; 0 keeps the requested cabin end to end. JSON: `max_mixed_cabin_share`. | |
| `--sort <order>` | No | miles (default), departure or duration. JSON: `sort`. | |
| `--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`. | |


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