Pricing & booking

Fetch the full lifecycle state of a trip — items, travelers, quote, fulfillment, and any booking references

Reads the latest trip state without starting pricing. After checkout fails, quote.status can be failed, with failure_reason and failure_message when available. A failed quote has no payment expires_at. Never treat a missing item price or total_amount as zero.

get/v1/trip/{trip_id}

Request

Base URL
https://api.gojinko.com
URL
https://api.gojinko.com/v1/trip/{trip_id}
Auth
- API key in header X-API-Key
- or HTTP bearer

Path parameters

trip_idstring required

Response

The trip

seat_map_urlstring

Link to a page where the traveller picks seats on a visual seat map. Present only when a flight item has a seat-map session. Expires; read the trip again for a fresh link.

trip_idstring required

Where the trip is in its lifecycle, as one value for the whole trip. The booking’s progress after payment is booking_state (GET /v1/trip/{trip_id}); the four booking values below (fulfilling, fulfilled, partially_fulfilled, failed) are deprecated in favour of it and still sent. draft: being built or priced, nothing paid. fulfilling: payment was submitted and booking started. Then exactly one outcome: fulfilled (booking_state completed), partially_fulfilled (partial) or failed (failed). cancelled: replaced by a new trip when it was re-shopped. expired is the 24-hour lapse: it is evaluated LAZILY, on the read that first observes it, so this call is where a dead trip becomes visible. Once a trip is expired, adding items, setting travelers and checkout are refused with TRIP_EXPIRED; any other state that refuses a write answers TRIP_STATE_CONFLICT and names the state here. Start a new trip — a lapsed one cannot be revived. quoting, quoted and fulfillment_prepared are reserved and not currently set; quote progress is in quote.status.

hotel_room_guestsHotelRoomGuests

Optional primary adult room-contact overrides keyed by the returned hotel item_id/product_id. Each product array is non-empty and occupancy_number values are unique positive room slots; omitted slots use persisted adult travelers in order with the trip contact email. The trip must already exist because the keys refer to its items.

The booking’s progress once payment has started; absent before. awaiting_payment: waiting for the payment to be confirmed. processing: booking with the suppliers. Then one outcome: completed (every item booked), partial (some items booked), failed (nothing booked) or cancelled. needs_review: held for a person at Jinko to resolve; not final. fulfillment.status keeps the detailed status behind it.

booking_refstring

The Jinko booking reference for this trip — the value POST /v1/get_booking, cancel, refund and exchange take as booking_ref, and the booking_ref every webhook event carries. Present as soon as booking has been scheduled for the trip, which can be before payment completes (a hosted checkout still in progress, or an agent submit that fell back to checkout_url, leaves the booking awaiting_payment). Presence does not mean paid: read booking_state. The value never changes afterwards. One per trip.

created_atstring

updated_atstring

Example response

{
  "payment_attempt": {
    "trip_id": "trip_1048576",
    "quote_id": "2097152",
    "failure_reason": "booking_not_created",
    "items": [
      {
        "booked_item_id": "itm_aaaaaaaaaaaaafhuxsdxpbzrbfz5hm3a",
        "failure_reason": "booking_not_created"
      }
    ],
    "money": {
      "authorized": {
        "value": 41250,
        "currency": "USD",
        "decimal_places": 2,
        "display": "USD 412.50"
      },
      "captured": {
        "value": 41250,
        "currency": "USD",
        "decimal_places": 2,
        "display": "USD 412.50"
      },
      "released": {
        "value": 41250,
        "currency": "USD",
        "decimal_places": 2,
        "display": "USD 412.50"
      },
      "refunded": {
        "value": 41250,
        "currency": "USD",
        "decimal_places": 2,
        "display": "USD 412.50"
      },
      "externally_reimbursed": {
        "value": 41250,
        "currency": "USD",
        "decimal_places": 2,
        "display": "USD 412.50"
      }
    }
  },
  "trip_id": "trip_1048576",
  "status": "draft",
  "travelers": [
    {
      "traveler_ref": "pax_1",
      "pax_ref_id": "pax_1",
      "first_name": "John",
      "last_name": "Doe",
      "date_of_birth": "1990-01-15",
      "gender": "MALE",
      "traveler_type": "adult",
      "passenger_type": "ADULT",
      "identity_documents": {
        "passport": {
          "status": "saved",
          "invalid_fields": [
            "passport_expiry"
          ]
        },
        "known_traveler_number": {
          "status": "saved",
          "invalid_fields": [
            "passport_expiry"
          ]
        },
        "redress_number": {
          "status": "saved",
          "invalid_fields": [
            "passport_expiry"
          ]
        }
      }
    }
  ],
  "items": [
    {
      "item_id": "itm_4b91c2",
      "kind": "flight",
      "offer_id": "htl_2d67a7441c60e5de",
      "trip_item_token": "of_9c1d2e:FARE_ABC",
      "hotel_id": "lp1f2c3",
      "booking_scope": "room_bundle",
      "num_rooms": 1,
      "rooms": [
        {
          "occupancy_number": 1,
          "room_name": "Superior Double",
          "board_type": "BB",
          "board_name": "Breakfast Included",
          "taxes_and_fees": [
            {
              "amount": 164.49,
              "currency": "EUR",
              "amount_money": {
                "value": 41250,
                "currency": "USD",
                "decimal_places": 2,
                "display": "USD 412.50"
              },
              "description": "19, VAT National taxes on accommodation",
              "included": true,
              "display": "EUR 164.49"
            }
          ],
          "policies": [
            {
              "fee_amount_money": {
                "value": 41250,
                "currency": "USD",
                "decimal_places": 2,
                "display": "USD 412.50"
              }
            }
          ],
          "cancellation_policy": [
            {
              "cancel_time": "2026-08-18T10:00:00+02:00",
              "amount": 606.13,
              "currency": "EUR",
              "type": "amount",
              "display": "EUR 606.13",
              "amount_money": {
                "value": 41250,
                "currency": "USD",
                "decimal_places": 2,
                "display": "USD 412.50"
              },
              "percent": 50,
              "nights": 1
            }
          ],
          "payment_types": [
            "pay_now"
          ]
        }
      ],
      "price": {
        "value": 41250,
        "currency": "USD",
        "decimal_places": 2,
        "display": "USD 412.50"
      },
      "price_money": {
        "value": 41250,
        "currency": "USD",
        "decimal_places": 2,
        "display": "USD 412.50"
      },
      "pax_count": 1,
      "available_ancillaries": [
        {
          "offer_id": "anc_3f9a1c27e4b8d051",
          "type": "bag",
          "label": "bag&1 x large 55 x 40 x 20 cm&Includes Speedy Boarding",
          "display_label": "bag, 1 x large 55 x 40 x 20 cm, Includes Speedy Boarding",
          "price_per_unit": {
            "value": 41250,
            "currency": "USD",
            "decimal_places": 2,
            "display": "USD 412.50"
          },
          "price_per_unit_money": {
            "value": 41250,
            "currency": "USD",
            "decimal_places": 2,
            "display": "USD 412.50"
          },
          "scope": "PER_PAX_PER_SEGMENT",
          "segment_ref_ids": [
            "seg_1"
          ],
          "seat_map": {
            "segment_ref_id": "seg_1",
            "flight_number": "W62202",
            "seats": [
              {
                "seat_number": "14A",
                "price": {
                  "value": 41250,
                  "currency": "USD",
                  "decimal_places": 2,
                  "display": "USD 412.50"
                },
                "price_money": {
                  "value": 41250,
                  "currency": "USD",
                  "decimal_places": 2,
                  "display": "USD 412.50"
                },
                "characteristics": [
                  "WINDOW"
                ]
              }
            ]
          },
          "per_pax": true,
          "max_quantity": 2,
          "paid_at": "now"
        }
      ],
      "selected_ancillaries": [
        {
          "offer_id": "anc_3f9a1c27e4b8d051",
          "traveler_ref": "pax_1",
          "pax_ref_id": "pax_1",
          "quantity": 1,
          "type": "seat",
          "seat_number": "14A",
          "segment_ref_ids": [
            "seg_1"
          ],
          "price": {
            "value": 41250,
            "currency": "USD",
            "decimal_places": 2,
            "display": "USD 412.50"
          },
          "price_money": {
            "value": 41250,
            "currency": "USD",
            "decimal_places": 2,
            "display": "USD 412.50"
          }
        }
      ],
      "price_changed": true,
      "original_price": {
        "value": 41250,
        "currency": "USD",
        "decimal_places": 2,
        "display": "USD 412.50"
      },
      "original_price_money": {
        "value": 41250,
        "currency": "USD",
        "decimal_places": 2,
        "display": "USD 412.50"
      },
      "price_change": {
        "original": {
          "value": 41250,
          "currency": "USD",
          "decimal_places": 2,
          "display": "USD 412.50"
        },
        "current": {
          "value": 41250,
          "currency": "USD",
          "decimal_places": 2,
          "display": "USD 412.50"
        },
        "delta": {
          "value": 41250,
          "currency": "USD",
          "decimal_places": 2,
          "display": "USD 412.50"
        },
        "original_money": {
          "value": 41250,
          "currency": "USD",
          "decimal_places": 2,
          "display": "USD 412.50"
        },
        "current_money": {
          "value": 41250,
          "currency": "USD",
          "decimal_places": 2,
          "display": "USD 412.50"
        },
        "delta_money": {
          "value": 41250,
          "currency": "USD",
          "decimal_places": 2,
          "display": "USD 412.50"
        }
      },
      "required_attributes": {
        "source": "provider",
        "per_passenger": [
          "PassportNumber",
          "PassportExpiryDate",
          "DateOfBirth"
        ],
        "booking": [
          "BillingAddress",
          "PostCode"
        ],
        "per_passenger_conditional": [
          "Nationality"
        ]
      },
      "hotel_terms": {
        "terms_as_of": "search",
        "taxes_breakdown": [
          {
            "amount": 164.49,
            "currency": "EUR",
            "amount_money": {
              "value": 41250,
              "currency": "USD",
              "decimal_places": 2,
              "display": "USD 412.50"
            },
            "description": "19, VAT National taxes on accommodation",
            "included": true,
            "display": "EUR 164.49"
          }
        ],
        "cancellation_schedule": [
          {
            "cancel_time": "2026-08-18T10:00:00+02:00",
            "amount": 606.13,
            "currency": "EUR",
            "type": "amount",
            "display": "EUR 606.13",
            "amount_money": {
              "value": 41250,
              "currency": "USD",
              "decimal_places": 2,
              "display": "USD 412.50"
            },
            "percent": 50,
            "nights": 1
          }
        ],
        "free_cancellation_until": "2026-08-18T10:00:00+02:00",
        "board_type": "RO",
        "board_name": "Room Only",
        "payment_types": [
          "pay_now"
        ],
        "room_name": "Superior Double",
        "room_capacity": 2
      }
    }
  ],
  "total_amount": {
    "value": 41250,
    "currency": "USD",
    "decimal_places": 2,
    "display": "USD 412.50"
  },
  "total_amount_money": {
    "value": 41250,
    "currency": "USD",
    "decimal_places": 2,
    "display": "USD 412.50"
  },
  "quote": {
    "quote_id": "2097152",
    "status": "quoted",
    "expires_at": "2026-06-01T13:04:56Z"
  },
  "fulfillment": {
    "failure_reason": "price_changed",
    "scheduled_at": "2026-06-01T12:35:00Z"
  },
  "booking_state": "processing",
  "booking_ref": "JNK-XEVGW5",
  "bookings": [
    {
      "item_id": "itm_4b91c2",
      "kind": "flight",
      "supplier_references": [
        {
          "issuer": "AF",
          "reference": "XM9L2K"
        }
      ],
      "booking_reference": "8Q69NYQTT",
      "pnr": "XM9L2K",
      "supplier_hold_released": true,
      "offer_id": "htl_2d67a7441c60e5de",
      "trip_item_token": "of_9c1d2e:FARE_ABC",
      "hotel_id": "lp1f2c3"
    }
  ],
  "created_at": "2026-06-01T12:30:00Z",
  "updated_at": "2026-06-01T12:34:56Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.