Skip to main content
Jinko logo
  • Category: scheduling & booking
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 13
  • Triggers: 0
  • Slug: JINKO
  • Version: 20261030_00

Tools

Slug: JINKO_ADD_TRIP_ITEMAdd 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

string
required
Existing Jinko trip identifier.
string
required
Flight trip_item_token or hotel offer_id to add to the existing trip.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: JINKO_CREATE_HOSTED_CHECKOUTQuote 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

string
required
Trip identifier with at least one item, travelers, and contact email and phone.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: JINKO_CREATE_TRIPCreate 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

string
required
Flight trip_item_token or hotel offer_id to add as the new trip’s first item.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: JINKO_FIND_DESTINATIONSDiscover 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

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

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: JINKO_GET_HOTEL_DETAILSGet 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

string
Optional check-in date in YYYY-MM-DD format to contextualize the property lookup.
string
Optional check-out date in YYYY-MM-DD format to contextualize the property lookup.
string
required
Hotel identifier returned by Search Hotels.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: JINKO_GET_TRIPRead 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

string
required
Trip identifier returned by Create Trip.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: JINKO_LIST_TRIP_ANCILLARIESCreate 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

string
required
Trip identifier containing a flight item.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: JINKO_REMOVE_TRIP_ITEMRemove 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

string
required
Identifier of the item to remove from the trip.
string
required
Existing Jinko trip identifier.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: JINKO_REPLACE_TRIP_TRAVELERS_AND_CONTACTReplace 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

object
Optional replacement booking contact; checkout later requires email and phone.
string
required
Existing Jinko trip identifier.
array
required
Complete non-empty traveler list that replaces the trip’s current travelers.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: JINKO_SEARCH_FLIGHT_CALENDARSearch 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

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

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: JINKO_SEARCH_FLIGHTSGet 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

Live route-search inputs. Provide this object or offer_token, never both.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: JINKO_SEARCH_HOTELSSearch 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

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

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: JINKO_SELECT_ANCILLARIESReplace 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

string
required
Trip item identifier whose ancillary selections are changing.
string
required
Trip identifier returned by Create Trip.
array
required
Complete set of ancillary offers to keep selected for this item; omitted prior selections are removed.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not