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

> Create and manage a trip — add or remove items, set travelers, select ancillaries

Assemble and edit a trip before sending it to checkout. Use it to add a flight or hotel offer, set traveler details, swap one item for another, or attach ancillaries like bags and seats. Flights and hotels can sit side by side in the same trip and settle through a single checkout.

## Usage

```bash theme={null}
jinko trip [options]
```

## Options

| Flag                        | Required | Description                                                                                                                                                                                                                                                                                                                                                            | Default |
| --------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- |
| `--trip-id <id>`            | No       | existing trip ID (omit to create new)                                                                                                                                                                                                                                                                                                                                  |         |
| `--trip-item-token <token>` | No       | add a flight item (from flight-search)                                                                                                                                                                                                                                                                                                                                 |         |
| `--remove-item-id <id>`     | No       | remove an existing item by item\_id (from a prior trip response items\[].item\_id). Requires --trip-id. Can be combined with --trip-item-token to swap an item in one call.                                                                                                                                                                                            |         |
| `--travelers <json>`        | No       | travelers JSON array. Required to complete a booking; date\_of\_birth + gender are required for flights but optional for hotel-only trips; each traveler may include an optional `frequent_flyer` \{airline, number} to credit airline miles (flights only; airline is the IATA program issuer, e.g. `LH`); the first traveler also supplies the booking contact name. |         |
| `--contact <json>`          | No       | contact JSON \{email, phone} — both required. Optional while building the cart, but required before booking.                                                                                                                                                                                                                                                           |         |

## Examples

```bash theme={null}
# Create a trip with an item + travelers in one call
jinko trip \
  --trip-item-token "$TRIP_ITEM_TOKEN" \
  --travelers '[{"first_name":"Jane","last_name":"Doe","date_of_birth":"1990-01-15","gender":"FEMALE","passenger_type":"ADULT","frequent_flyer":{"airline":"LH","number":"992100100"}}]' \
  --contact '{"email":"jane@example.com","phone":"+33612345678"}'

# Add another item to an existing trip
jinko trip --trip-id 42 --trip-item-token "htl_def..."
```