Get Trip

Inspect the current state of a trip without modifying it. Reach for it when you need to confirm what items are on the trip, verify the travelers attached to a booking, or check whether a checkout has finalized after the user paid. The response covers items, traveler details, quote status, and any booking references that have been issued.

Tool description (what the LLM sees)

Fetch the full lifecycle state of a trip, its items, travelers, quote status, fulfillment status, and any booking references already produced.

USAGE:
  get_trip({ trip_id })

This is a read-only call. Use it to inspect a trip after trip(add_item), trip(upsert_travelers), or checkout, for example to confirm what items / travelers are currently on the trip, or to check whether a booking has been finalized post-checkout.

In structuredContent, lifecycle data is nested under trip. Until payment starts, trip.status reads "draft" ("expired" once the trip is left untouched for 24 hours): checkout prices the trip but books and charges nothing, so a priced, unpaid trip reads trip.status "draft" with trip.quote.status "completed". Read progress from three fields: trip.quote.status (pricing), trip.payment_attempt.payment_status (payment), trip.booking_state (booking: awaiting_payment, processing, completed, partial, failed, cancelled or needs_review; trip.fulfillment.status has the detailed status). trip.fulfillment, trip.booking_ref and trip.booking_state appear when payment starts (the traveller presses Pay at checkout_url, or submit_agent_payment is called); trip.booking_state "awaiting_payment" means the payment is not authorized yet. The text answer's Stage line says where an unpaid trip stands.

Read trip.booking_ref (JNK-XXXXXX) for the Jinko booking reference, which get_booking, hotel_cancel and flight_refund take as booking_ref. It can be present before payment completes, do not treat its presence as paid; check trip.booking_state. The value never changes afterwards. trip.bookings[].supplier_references are the SUPPLIER confirmations (airline record locator / hotel confirmation number, each with its issuer) and are NOT accepted by get_booking.

trip.quote.invalid_reason = "travelers_changed" means the travelers were edited after the quote was priced: the quote can no longer be paid, so call checkout again before paying.

Parameters

Name	Type	Required	Description
`trip_id`	`string`	Yes	Trip ID returned by trip, get_trip, or checkout. Pass it back exactly as returned.
`user_intent`	`string`	No	The end user’s current request in their own words, e.g. “help me with my travel plans”. Pass it as-is when short; otherwise condense the goal and constraints into 1-2 sentences. Strip personal identifiers (names, emails, phone numbers, addresses, payment details), replace them with placeholders like “[name]”. Optional. Jinko uses it to understand demand, and hotel_search uses it to rank hotel results against what the user asked for (e.g. “quiet, with a gym, near Times Square”), so keep the user’s stated preferences in it.

Examples

Inspect a trip’s lifecycle state: Use the trip_id returned by trip or checkout; "1128" below is an example.

{
  "name": "get_trip",
  "arguments": { "trip_id": "1128" }
}

Abbreviated structuredContent for an empty draft trip:

{
  "status": "success",
  "trip_id": "1128",
  "trip": {
    "trip_id": "1128",
    "status": "draft",
    "items": [],
    "travelers": []
  }
}

structuredContent.status reports whether the lookup succeeded. Read the trip’s lifecycle state from structuredContent.trip.status and, once payment starts, the booking’s progress from structuredContent.trip.booking_state, and its items and travelers from structuredContent.trip.items and structuredContent.trip.travelers. Quote, fulfillment, and booking details, when present, are also inside structuredContent.trip. Use structuredContent.trip.booking_ref (Jinko reference) for lookup and servicing. It can appear before payment completes. Within structuredContent.trip.bookings[], supplier_references lists each item’s supplier confirmations, [] when none is known. Failed items can also appear in that array, and an entry carries no outcome of its own: read structuredContent.trip.booking_state for the outcome.

Introduction

Flights

Hotels

Cars

Trip & Payment

Marketing claim

Parameters

Examples

​Parameters

​Examples

Parameters

Examples