> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Jinko

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

![Jinko logo](https://mintcdn.com/composio-preview/tIuAovF9-7pXq2wA/images/toolkits/jinko.svg?fit=max\&auto=format\&n=tIuAovF9-7pXq2wA\&q=85\&s=bee4ee67f2a5cdf6333320f3512ae3d5)

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

## Tools

> [accordion] 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
>
> **trip\_id** `string` *required*
>
> Existing Jinko trip identifier.
>
> **trip\_item\_token** `string` *required*
>
> Flight trip\_item\_token or hotel offer\_id to add to the existing trip.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **trip\_id** `string` *required*
>
> Trip identifier with at least one item, travelers, and contact email and phone.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **trip\_item\_token** `string` *required*
>
> Flight trip\_item\_token or hotel offer\_id to add as the new trip's first item.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **limit** `integer`
>
> Maximum destinations requested for this page.
>
> **locale** `string`
>
> Preferred locale.
>
> **offset** `integer`
>
> Number of destination results to skip for manual continuation.
>
> **origins** `array` *required*
>
> Origin city or airport codes.
>
> **sort\_by** `string ("lowest" | "recommendation")`
>
> Sort by lowest fare or provider recommendation.
>
> **currency** `string`
>
> Preferred ISO 4217 currency code.
>
> **max\_total** `number`
>
> Maximum total trip price in the requested currency's major units.
>
> **stay\_days** `integer`
>
> Exact trip length in days; do not combine with stay\_days\_range.
>
> **travelers** `object`
>
> Passenger counts and optional ages, flattened into the Jinko request.
>
> **trip\_type** `string ("oneway" | "roundtrip")` *required*
>
> Whether to discover one-way or round-trip options.
>
> **cabin\_class** `string ("economy" | "premium_economy" | "business" | "first")`
>
> Requested cabin class.
>
> **direct\_only** `boolean`
>
> Return only direct-flight suggestions when true.
>
> **origin\_type** `string ("city" | "airport")`
>
> Interpret every origin code as a city or an airport.
>
> **destinations** `array`
>
> Destination city or airport codes to include in discovery.
>
> **return\_dates** `array`
>
> Exact acceptable return dates for a round trip.
>
> **departure\_dates** `array`
>
> Exact acceptable departure dates.
>
> **stay\_days\_range** `object`
>
> Allowed trip-length range; do not combine with stay\_days.
>
> **destination\_type** `string ("city" | "airport")`
>
> Interpret every destination code as a city or an airport.
>
> **residency\_country** `string`
>
> Traveler residency as a two-letter country code.
>
> **return\_date\_ranges** `array`
>
> Inclusive acceptable return windows.
>
> **departure\_date\_ranges** `array`
>
> Inclusive acceptable departure windows.
>
> **flights\_per\_destination** `integer`
>
> Maximum priced flight options to include for each destination.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **checkin** `string`
>
> Optional check-in date in YYYY-MM-DD format to contextualize the property lookup.
>
> **checkout** `string`
>
> Optional check-out date in YYYY-MM-DD format to contextualize the property lookup.
>
> **hotel\_id** `string` *required*
>
> Hotel identifier returned by Search Hotels.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **trip\_id** `string` *required*
>
> Trip identifier returned by Create Trip.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **trip\_id** `string` *required*
>
> Trip identifier containing a flight item.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **item\_id** `string` *required*
>
> Identifier of the item to remove from the trip.
>
> **trip\_id** `string` *required*
>
> Existing Jinko trip identifier.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **contact** `object`
>
> Optional replacement booking contact; checkout later requires email and phone.
>
> **trip\_id** `string` *required*
>
> Existing Jinko trip identifier.
>
> **travelers** `array` *required*
>
> Complete non-empty traveler list that replaces the trip's current travelers.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **limit** `integer`
>
> Maximum cached itineraries requested for this page.
>
> **locale** `string`
>
> Preferred locale.
>
> **offset** `integer`
>
> Number of cached itineraries to skip for manual continuation.
>
> **origins** `array` *required*
>
> Origin city or airport codes, such as NYC or JFK.
>
> **sort\_by** `string ("lowest" | "recommendation")`
>
> Sort by lowest fare or provider recommendation.
>
> **currency** `string`
>
> Preferred ISO 4217 currency code.
>
> **max\_total** `number`
>
> Maximum total itinerary price in major currency units.
>
> **stay\_days** `integer`
>
> Exact trip length in days; do not combine with stay\_days\_range.
>
> **travelers** `object`
>
> Passenger counts and optional ages. These fields are flattened into the provider request.
>
> **trip\_type** `string ("oneway" | "roundtrip")` *required*
>
> Whether to search one-way or round-trip itineraries.
>
> **cabin\_class** `string ("economy" | "premium_economy" | "business" | "first")`
>
> Requested cabin class.
>
> **direct\_only** `boolean`
>
> Return only direct itineraries when true.
>
> **origin\_type** `string ("city" | "airport")`
>
> Interpret every origin code as a city or an airport.
>
> **destinations** `array` *required*
>
> Destination city or airport codes, such as LAX.
>
> **return\_dates** `array`
>
> Exact acceptable return dates, each as YYYY-MM-DD.
>
> **departure\_dates** `array`
>
> Exact acceptable departure dates, each as YYYY-MM-DD.
>
> **stay\_days\_range** `object`
>
> Allowed trip-length range; do not combine with stay\_days.
>
> **destination\_type** `string ("city" | "airport")`
>
> Interpret every destination code as a city or an airport.
>
> **residency\_country** `string`
>
> Traveler residency as a two-letter country code.
>
> **return\_date\_ranges** `array`
>
> Inclusive acceptable return windows.
>
> **departure\_date\_ranges** `array`
>
> Inclusive acceptable departure windows.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **search** `object`
>
> Live route-search inputs. Provide this object or offer\_token, never both.
>
> **offer\_token** `string`
>
> 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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **checkin** `string`
>
> Check-in date for the first page; omit when continuing with next\_cursor.
>
> **checkout** `string`
>
> Check-out date after check-in for the first page; omit when continuing with next\_cursor.
>
> **currency** `string`
>
> Preferred ISO 4217 currency code.
>
> **location** `object`
>
> Location for the first page. Choose exactly one selector type; omit when continuing with next\_cursor.
>
> **chain\_ids** `array`
>
> Allowed hotel chain identifiers.
>
> **min\_rating** `number`
>
> Minimum guest review rating.
>
> **max\_results** `integer`
>
> Maximum hotels requested for this page. The provider may advance by a different offset.
>
> **min\_reviews** `integer`
>
> Minimum number of guest reviews.
>
> **next\_cursor** `string`
>
> Opaque continuation returned by a previous call. Pass it alone to restore the original search and use Jinko's exact next offset.
>
> **occupancies** `array`
>
> One object per room, with adult count and optional child ages.
>
> **star\_rating** `integer`
>
> Exact hotel star rating.
>
> **facility\_ids** `array`
>
> Required provider facility identifiers.
>
> **hotel\_type\_ids** `array`
>
> Allowed provider hotel type identifiers.
>
> **max\_star\_rating** `integer`
>
> Maximum hotel star rating.
>
> **min\_star\_rating** `integer`
>
> Minimum hotel star rating.
>
> **guest\_nationality** `string`
>
> Guest nationality as a two-letter country code for rate eligibility.
>
> **max\_budget\_per\_night** `number`
>
> Maximum nightly price per room in the requested currency's major units.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **item\_id** `string` *required*
>
> Trip item identifier whose ancillary selections are changing.
>
> **trip\_id** `string` *required*
>
> Trip identifier returned by Create Trip.
>
> **selections** `array` *required*
>
> Complete set of ancillary offers to keep selected for this item; omitted prior selections are removed.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
