Skip to main content
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.
Fetch the full lifecycle state of a trip — cart contents, 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 book — for example to confirm what items / travelers are currently on the cart, or to check whether a booking has been finalized post-checkout.

Parameters

NameTypeRequiredDescription
trip_idstringYesTrip ID returned from a previous trip(add_item) or book call.

Examples

Inspect a trip’s lifecycle state:
{
  "name": "get_trip",
  "arguments": { "trip_id": "42" }
}
Abbreviated response:
{
  "trip_id": "42",
  "status": "fulfilling",
  "items": [
    { "item_id": 7, "kind": "flight", "trip_item_token": "...", "price": { "total": 842.30 } }
  ],
  "travelers": [{ "first_name": "Jane", "last_name": "Doe", "passenger_type": "ADULT" }],
  "quote": {
    "status": "succeeded",
    "totals": { "subtotal": 842.30, "fees": 0, "total": 842.30, "currency": "USD" }
  },
  "fulfillment": {
    "status": "fulfilling",
    "scheduled_at": "2026-04-21T15:00:00Z"
  },
  "bookings": []
}
Once fulfillment.status is completed, bookings[] populates with booking_ref (Jinko reference) and pnr (airline reference). These are what you surface in confirmation emails or share with the customer.