---
canonical_url: "https://docs.composio.dev/toolkits/jinko"
markdown_url: "https://docs.composio.dev/toolkits/jinko.md"
product: "platform"
version: null
last_updated: null
---

# Jinko

Jinko provides flight and hotel discovery, trip management, ancillaries, and hosted travel checkout APIs.

- **Category:** scheduling & booking
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 13
- **Triggers:** 0
- **Slug:** `JINKO`
- **Version:** 00000000_00

## Tools

### Add Trip Item

**Slug:** `JINKO_ADD_TRIP_ITEM`

Add one flight or hotel offer to an existing trip. Returns the successful mutation snapshot and a best-effort canonical trip read; if that read fails, the warning confirms the mutation succeeded and must not be retried blindly.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `trip_id` | string | Yes | Existing Jinko trip identifier. |
| `trip_item_token` | string | Yes | Flight trip_item_token or hotel offer_id to add to the existing trip. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Hosted Checkout

**Slug:** `JINKO_CREATE_HOSTED_CHECKOUT`

Quote a complete trip and create a hosted checkout URL for a person to review and pay. This tool neither opens checkout nor submits payment nor creates a booking; create a fresh checkout if the quote expires.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `trip_id` | string | Yes | Trip identifier with at least one item, travelers, and contact email and phone. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Trip

**Slug:** `JINKO_CREATE_TRIP`

Create a new trip containing one flight or hotel offer. Returns the successful mutation snapshot and a best-effort canonical trip read; if that read fails, the warning confirms the mutation succeeded and must not be retried blindly.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `trip_item_token` | string | Yes | Flight trip_item_token or hotel offer_id to add as the new trip's first item. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Find Destinations

**Slug:** `JINKO_FIND_DESTINATIONS`

Discover destinations reachable from one or more origins using cached fare data, with optional dates, budget, cabin, and passenger constraints. Increase offset to request another page; returned_count describes only this page.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum destinations requested for this page. |
| `locale` | string | No | Preferred locale. |
| `offset` | integer | No | Number of destination results to skip for manual continuation. |
| `origins` | array | Yes | Origin city or airport codes. |
| `sort_by` | string ("lowest" | "recommendation") | No | Sort by lowest fare or provider recommendation. |
| `currency` | string | No | Preferred ISO 4217 currency code. |
| `max_total` | number | No | Maximum total trip price in the requested currency's major units. |
| `stay_days` | integer | No | Exact trip length in days; do not combine with stay_days_range. |
| `travelers` | object | No | Passenger counts and optional ages, flattened into the Jinko request. |
| `trip_type` | string ("oneway" | "roundtrip") | Yes | Whether to discover one-way or round-trip options. |
| `cabin_class` | string ("economy" | "premium_economy" | "business" | "first") | No | Requested cabin class. |
| `direct_only` | boolean | No | Return only direct-flight suggestions when true. |
| `origin_type` | string ("city" | "airport") | No | Interpret every origin code as a city or an airport. |
| `destinations` | array | No | Destination city or airport codes to include in discovery. |
| `return_dates` | array | No | Exact acceptable return dates for a round trip. |
| `departure_dates` | array | No | Exact acceptable departure dates. |
| `stay_days_range` | object | No | Allowed trip-length range; do not combine with stay_days. |
| `destination_type` | string ("city" | "airport") | No | Interpret every destination code as a city or an airport. |
| `residency_country` | string | No | Traveler residency as a two-letter country code. |
| `return_date_ranges` | array | No | Inclusive acceptable return windows. |
| `departure_date_ranges` | array | No | Inclusive acceptable departure windows. |
| `flights_per_destination` | integer | No | Maximum priced flight options to include for each destination. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Hotel Details

**Slug:** `JINKO_GET_HOTEL_DETAILS`

Get descriptive property, policy, facility, image, and room metadata for one hotel. Rooms are descriptive and unpriced; use Search Hotels for current rates and bookable hotel offer IDs.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `checkin` | string | No | Optional check-in date in YYYY-MM-DD format to contextualize the property lookup. |
| `checkout` | string | No | Optional check-out date in YYYY-MM-DD format to contextualize the property lookup. |
| `hotel_id` | string | Yes | Hotel identifier returned by Search Hotels. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Trip

**Slug:** `JINKO_GET_TRIP`

Read the canonical current state of a trip, including items, travelers, contact, quote and fulfillment state, totals, and booking references. Use this instead of relying on a prior mutation response.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `trip_id` | string | Yes | Trip identifier returned by Create Trip. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Trip Ancillaries

**Slug:** `JINKO_LIST_TRIP_ANCILLARIES`

Create or reuse a price quote and list purchasable baggage, seat, meal, and other ancillary offers for a trip without creating checkout. Creating the quote can update the trip's quote state and consume Jinko account credit; completed quotes are reused while valid. If Jinko is still pricing, this tool polls until ready or times out; it never returns a hosted checkout URL.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `trip_id` | string | Yes | Trip identifier containing a flight item. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Remove Trip Item

**Slug:** `JINKO_REMOVE_TRIP_ITEM`

Remove one flight or hotel item from an existing trip. This is destructive. Returns the successful mutation snapshot and a best-effort canonical trip read; if that read fails, do not retry blindly and reconcile with Get Trip.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `item_id` | string | Yes | Identifier of the item to remove from the trip. |
| `trip_id` | string | Yes | Existing Jinko trip identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Replace Trip Travelers and Contact

**Slug:** `JINKO_REPLACE_TRIP_TRAVELERS_AND_CONTACT`

Replace an existing trip's complete traveler list and optionally its booking contact. Travelers cannot be empty. Returns the successful mutation snapshot and a best-effort canonical read; a read warning must not trigger a blind retry.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `contact` | object | No | Optional replacement booking contact; checkout later requires email and phone. |
| `trip_id` | string | Yes | Existing Jinko trip identifier. |
| `travelers` | array | Yes | Complete non-empty traveler list that replaces the trip's current travelers. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Flight Calendar

**Slug:** `JINKO_SEARCH_FLIGHT_CALENDAR`

Search cached priced itineraries for known origins and destinations across exact or flexible dates. This does not live-price fares; pass an itinerary's offer token to Search Flights before adding a fare to a trip.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum cached itineraries requested for this page. |
| `locale` | string | No | Preferred locale. |
| `offset` | integer | No | Number of cached itineraries to skip for manual continuation. |
| `origins` | array | Yes | Origin city or airport codes, such as NYC or JFK. |
| `sort_by` | string ("lowest" | "recommendation") | No | Sort by lowest fare or provider recommendation. |
| `currency` | string | No | Preferred ISO 4217 currency code. |
| `max_total` | number | No | Maximum total itinerary price in major currency units. |
| `stay_days` | integer | No | Exact trip length in days; do not combine with stay_days_range. |
| `travelers` | object | No | Passenger counts and optional ages. These fields are flattened into the provider request. |
| `trip_type` | string ("oneway" | "roundtrip") | Yes | Whether to search one-way or round-trip itineraries. |
| `cabin_class` | string ("economy" | "premium_economy" | "business" | "first") | No | Requested cabin class. |
| `direct_only` | boolean | No | Return only direct itineraries when true. |
| `origin_type` | string ("city" | "airport") | No | Interpret every origin code as a city or an airport. |
| `destinations` | array | Yes | Destination city or airport codes, such as LAX. |
| `return_dates` | array | No | Exact acceptable return dates, each as YYYY-MM-DD. |
| `departure_dates` | array | No | Exact acceptable departure dates, each as YYYY-MM-DD. |
| `stay_days_range` | object | No | Allowed trip-length range; do not combine with stay_days. |
| `destination_type` | string ("city" | "airport") | No | Interpret every destination code as a city or an airport. |
| `residency_country` | string | No | Traveler residency as a two-letter country code. |
| `return_date_ranges` | array | No | Inclusive acceptable return windows. |
| `departure_date_ranges` | array | No | Inclusive acceptable departure windows. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Flights

**Slug:** `JINKO_SEARCH_FLIGHTS`

Get live flight offers either by searching a route or by re-pricing one cached discovery offer. Provide exactly one of search or offer_token; re-pricing can return multiple alternatives and exact_match_found may be false.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `search` | object | No | Live route-search inputs. Provide this object or offer_token, never both. |
| `offer_token` | string | No | Cached offer token from Find Destinations or Search Flight Calendar to re-price. Provide this or search, never both; no search fields are sent in this mode. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Hotels

**Slug:** `JINKO_SEARCH_HOTELS`

Search live hotel availability and priced room rates for dates, occupancy, and one location selector. Pass next_cursor by itself to continue the same search using Jinko's exact next offset.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `checkin` | string | No | Check-in date for the first page; omit when continuing with next_cursor. |
| `checkout` | string | No | Check-out date after check-in for the first page; omit when continuing with next_cursor. |
| `currency` | string | No | Preferred ISO 4217 currency code. |
| `location` | object | No | Location for the first page. Choose exactly one selector type; omit when continuing with next_cursor. |
| `chain_ids` | array | No | Allowed hotel chain identifiers. |
| `min_rating` | number | No | Minimum guest review rating. |
| `max_results` | integer | No | Maximum hotels requested for this page. The provider may advance by a different offset. |
| `min_reviews` | integer | No | Minimum number of guest reviews. |
| `next_cursor` | string | No | Opaque continuation returned by a previous call. Pass it alone to restore the original search and use Jinko's exact next offset. |
| `occupancies` | array | No | One object per room, with adult count and optional child ages. |
| `star_rating` | integer | No | Exact hotel star rating. |
| `facility_ids` | array | No | Required provider facility identifiers. |
| `hotel_type_ids` | array | No | Allowed provider hotel type identifiers. |
| `max_star_rating` | integer | No | Maximum hotel star rating. |
| `min_star_rating` | integer | No | Minimum hotel star rating. |
| `guest_nationality` | string | No | Guest nationality as a two-letter country code for rate eligibility. |
| `max_budget_per_night` | number | No | Maximum nightly price per room in the requested currency's major units. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Select Ancillaries

**Slug:** `JINKO_SELECT_ANCILLARIES`

Replace the ancillary selections for one trip item using offer IDs from List Trip Ancillaries. This updates the quoted trip price but does not create checkout or submit payment.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `item_id` | string | Yes | Trip item identifier whose ancillary selections are changing. |
| `trip_id` | string | Yes | Trip identifier returned by Create Trip. |
| `selections` | array | Yes | Complete set of ancillary offers to keep selected for this item; omitted prior selections are removed. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |