Post-booking

Retrieve booked item IDs and per-item servicing eligibility using the Jinko booking reference

Call get_booking first. Use booking_ref and the selected booked_item_id for every servicing action. last_name is required for guest lookup; an owning credential may omit it. The deprecated provider, order_id, provider_reference and provider_booking_id are accepted until 2027-04-30 where the request declares them; a request that sends one is answered with Deprecation and Sunset headers. A 409 item_selection_required returns safe items to choose from.

post/v1/get_booking

Request

  • Base URL
    https://api.gojinko.com
  • URL
    https://api.gojinko.com/v1/get_booking
  • Auth
    • API key in header X-API-Key
    • or HTTP bearer

Request body

booking_refstring required

Jinko booking reference. Call get_booking first, then select its booked_item_id for servicing.

last_namestring

Required for guest lookup. A credential that owns the booking may omit it; ownership is checked by the platform.

check_eligibilityboolean

Whether to check now, with the airline or supplier, if each item can be voided, refunded or exchanged (items[].servicing). For a flight this asks the airline and can add several seconds. Send false to read the booking and its stored fare_conditions only; the eligibility fields are then left out of items[].servicing. Defaults to true; after a 180-day notice the default becomes false, so send true explicitly before cancelling or changing.

Example request

{
  "booking_ref": "JNK-A0AUR2",
  "last_name": "Doe",
  "intent": {
    "user_intent": "find a cheap flight to Tokyo"
  }
}

Response

Retrieve booked item IDs and per-item servicing eligibility using the Jinko booking reference

Example response

{
  "booking": {
    "booking_ref": "JNK-A0AUR2",
    "booking_reference": "JNK-A0AUR2",
    "status": "completed",
    "type": "flight",
    "last_name": "Doe",
    "total_paid": {
      "value": 31840,
      "currency": "USD",
      "decimal_places": 2,
      "display": "USD 318.40"
    },
    "created_at": "2026-05-20T09:14:00Z",
    "calendar": {
      "files": [
        {
          "method": "REQUEST",
          "filename": "jinko-JNK-A0AUR2.ics",
          "content_type": "text/calendar; charset=utf-8; method=REQUEST",
          "content": "BEGIN:VCALENDAR\\r\\nVERSION:2.0\\r\\n…\\r\\nEND:VCALENDAR\\r\\n"
        }
      ]
    }
  }
}

Changes

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