> ## 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 car-search

> Search live car-rental offers

Search live car-rental inventory for a pick-up location, date-time window and driver age. Pick-up and drop-off times are BRANCH-LOCAL with no timezone (2026-09-12T10:00:00), the rental desk's own wall clock. Give exactly one of --pick-up-airport, --pick-up-place or --pick-up-geo; a free-text --pick-up-place that resolves ambiguously comes back as a candidate list instead of offers, which is a retry signal, not an error. Each offer's `offer_id` is a trip item token you can hand straight to the trip command to start a booking.

## Usage

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

## Options

| Flag                              | Required | Description                                                                                                                                                               | Default |
| --------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- |
| `--pick-up-date-time <datetime>`  | Yes      | pick-up date-time, branch-local, no timezone: 2026-09-12T10:00:00. JSON: `pick_up.date_time`.                                                                             |         |
| `--pick-up-airport <code>`        | No       | pick-up IATA airport code, e.g. LYS. JSON: `pick_up.airport_code`.                                                                                                        |         |
| `--pick-up-place <text>`          | No       | free-text pick-up location, a city, district or landmark, e.g. "Lyon city centre". Resolved server-side. JSON: `pick_up.place`.                                           |         |
| `--pick-up-geo <lat,lng,range>`   | No       | pick-up coordinates and search radius in metres (min 50), e.g. 45.72,4.94,5000. JSON: `pick_up.geo`.                                                                      |         |
| `--drop-off-date-time <datetime>` | No       | drop-off date-time, branch-local, no timezone. JSON: `drop_off_date_time`. \[required unless a --drop-off-\* location carries its own time]                               |         |
| `--drop-off-airport <code>`       | No       | drop-off IATA airport code, for a one-way rental. JSON: `drop_off.airport_code`.                                                                                          |         |
| `--drop-off-place <text>`         | No       | free-text drop-off location, for a one-way rental. JSON: `drop_off.place`.                                                                                                |         |
| `--drop-off-geo <lat,lng,range>`  | No       | drop-off coordinates and radius, for a one-way rental. JSON: `drop_off.geo`.                                                                                              |         |
| `--driver-age <age>`              | Yes      | driver's age at pick-up, 18-99. Pricing and availability are age-dependent. JSON: `driver_age`.                                                                           |         |
| `--residence-country <code>`      | Yes      | driver's country of residence, ISO 3166-1 alpha-2, e.g. FR. Rates and inclusions vary by residence. JSON: `residence_country`.                                            |         |
| `--currency <code>`               | No       | ISO 4217 display currency, e.g. EUR. Defaults to USD. JSON: `currency`.                                                                                                   |         |
| `--lang <tag>`                    | No       | BCP-47 language tag for vehicle and branch text, e.g. en-gb. JSON: `lang`.                                                                                                |         |
| `--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`. |         |