> ## 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 price-monitoring

> Monitor price for a specific origin, destination, and dates pair

Watch a specific route and date pair over time so an agent can act when the fare drops. Use it for prompts like "alert me when Paris to New York for June 17 to 26 goes under €400". Each response includes the current cheapest cached fare and an offer token you can pass to flight\_search when the user decides to book. Cache-only; never triggers a live call.

## Usage

```bash theme={null}
jinko price-monitoring [options]
```

## Options

| Flag                            | Required | Description                                                                       | Default  |
| ------------------------------- | -------- | --------------------------------------------------------------------------------- | -------- |
| `--origin <code>`               | Yes      | origin IATA code (e.g. PAR for city, CDG for airport). JSON: `origin`.            |          |
| `--destination <code>`          | Yes      | destination IATA code (e.g. NYC for city, JFK for airport). JSON: `destination`.  |          |
| `--origin-type <type>`          | No       | origin code type: city or airport (default: city). JSON: `origin_type`.           | `"city"` |
| `--destination-type <type>`     | No       | destination code type: city or airport (default: city). JSON: `destination_type`. | `"city"` |
| `--departure-date <date>`       | Yes      | departure date (YYYY-MM-DD). JSON: `departure_date`.                              |          |
| `--return-date <date>`          | No       | return date for round-trip (YYYY-MM-DD). JSON: `return_date`.                     |          |
| `--adults <n>`                  | No       | number of adult passengers (default: 1). JSON: `adults`.                          |          |
| `--cabin-class <class>`         | No       | cabin class: economy, premium\_economy, business, first. JSON: `cabin_class`.     |          |
| `--direct-only`                 | No       | only consider direct flights. JSON: `direct_only`.                                |          |
| `--max-price <amount>`          | No       | upper bound on total fare. JSON: `max_price`.                                     |          |
| `--include-carriers <codes...>` | No       | whitelist IATA 2-letter carrier codes (e.g. AF KL). JSON: `include_carriers`.     |          |
| `--exclude-carriers <codes...>` | No       | blacklist IATA 2-letter carrier codes (e.g. FR U2). JSON: `exclude_carriers`.     |          |
| `--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.                                                         |          |

## Examples

```bash theme={null}
# Plain poll for the cheapest cached PAR → NYC.
jinko price-monitoring --origin PAR --destination NYC \
  --departure-date 2026-06-17 --return-date 2026-06-26 --format json
```

```bash theme={null}
# Cron entry: poll every 6 hours, alert on a hit.
# 0 */6 * * *
jinko price-monitoring --origin PAR --destination NYC \
    --departure-date 2026-06-17 --return-date 2026-06-26 \
    --direct-only --cabin-class economy --max-price 800 \
    --format json | jq -e '.status == "ok"' \
  && /usr/local/bin/notify-on-price-drop.sh
```