> ## 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 exchange shop

> Shop for flight exchange alternatives

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

Shop for flight exchange alternatives.

## Usage

```bash theme={null}
jinko exchange shop [options]
```

## Options

| Flag                                | Required | Description                                                                                                                                                               | Default |
| ----------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- |
| `--booking-ref <ref>`               | Yes      | Jinko booking reference                                                                                                                                                   |         |
| `--last-name <name>`                | Yes      | Last name of the primary traveler                                                                                                                                         |         |
| `--provider <provider>`             | No       | override provider hint                                                                                                                                                    |         |
| `--ticket-numbers <numbers...>`     | No       | one or more ticket numbers                                                                                                                                                |         |
| `--preferred-departure-date <date>` | No       | preferred departure date (YYYY-MM-DD)                                                                                                                                     |         |
| `--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}
jinko exchange shop \
  --booking-ref JNK-ABC123 \
  --last-name Doe \
  --new-departure-date 2026-07-15
```

Returns alternative itineraries with `offer_id` values, pick one and pass to `jinko exchange price`.