GOgojinko
Post-booking

Price a specific exchange offer

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/exchange_price

Request

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

Request body

booking_refstring

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

booked_item_idstring

The booked item, from get_booking items[].booked_item_id. Preserved across exchanges. Omit only when the booking has exactly one item of the requested domain; otherwise a 409 returns items to choose from.

last_namestring

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

order_idstring

Deprecated: name the booking with booking_ref and booked_item_id from get_booking. Names the booking instead of booking_ref, never beside it, and needs a credential that owns the booking. Accepted until 2027-04-30; a request that sends it is answered with Deprecation and Sunset headers.

providerstring

Deprecated: omit it. The platform uses the supplier recorded with the booking. Accepted until 2027-04-30; a request that sends it is answered with Deprecation and Sunset headers.

offer_idstring required

Example request

{
  "booking_ref": "JNK-A0AUR2",
  "last_name": "Doe",
  "offer_id": "exch_offer_3c1a9f"
}

Response

Price a specific exchange offer

payment_outcomestring

What the customer's money does: ADD_COLLECT — they pay total_due; REFUND — they get total_refund back; EVEN — nothing moves. It is the customer's outcome, which can differ from the supplier's. The list may grow: handle a value you do not know.

quote_idstring

This price’s quote. Pass it as quote_id to exchange_commit when committing the same offer after a refused price, to request manual handling.

session_referencestring

Deprecated: use quote_id instead. Same value.

expires_atstring
warningsstring[]

Notes about the booking and its documents, each said once, in words the customer can be shown. A note the supplier sends as free text without a code is left out.

Example response

{
  "payment_outcome": "ADD_COLLECT",
  "customer_amounts": {
    "original_fare": {
      "value": 41250,
      "currency": "USD",
      "decimal_places": 2,
      "display": "USD 412.50"
    },
    "new_fare": {
      "value": 41250,
      "currency": "USD",
      "decimal_places": 2,
      "display": "USD 412.50"
    },
    "penalty_amount": {
      "value": 41250,
      "currency": "USD",
      "decimal_places": 2,
      "display": "USD 412.50"
    },
    "total_due": {
      "value": 41250,
      "currency": "USD",
      "decimal_places": 2,
      "display": "USD 412.50"
    },
    "total_refund": {
      "value": 41250,
      "currency": "USD",
      "decimal_places": 2,
      "display": "USD 412.50"
    },
    "residual_value": {
      "value": 41250,
      "currency": "USD",
      "decimal_places": 2,
      "display": "USD 412.50"
    }
  },
  "fare_difference": {
    "value": 41250,
    "currency": "USD",
    "decimal_places": 2,
    "display": "USD 412.50"
  },
  "penalty_amount": {
    "value": 41250,
    "currency": "USD",
    "decimal_places": 2,
    "display": "USD 412.50"
  },
  "original_fare": {
    "value": 41250,
    "currency": "USD",
    "decimal_places": 2,
    "display": "USD 412.50"
  },
  "new_fare": {
    "value": 41250,
    "currency": "USD",
    "decimal_places": 2,
    "display": "USD 412.50"
  },
  "total_due": {
    "value": 41250,
    "currency": "USD",
    "decimal_places": 2,
    "display": "USD 412.50"
  },
  "total_refund": {
    "value": 41250,
    "currency": "USD",
    "decimal_places": 2,
    "display": "USD 412.50"
  },
  "new_fare_details": {
    "fare_brand_name": "MAIN CABIN FLEXIBLE",
    "fare_brand_code": "MAINFL",
    "endorsements": "USD281.86 NONREFUNDABLE/NONREF/FAREDIF/CXL BY FLT TIME OR NOVALUE",
    "refund_policy": "Non-refundable",
    "change_policy": "Changeable (conditions apply)",
    "checked_baggage": {
      "weight_unit": "KG",
      "description": "1 bag, 23kg included"
    },
    "carry_on_baggage": {
      "weight_unit": "KG",
      "description": "1 bag, 23kg included"
    },
    "extra_baggage_options": [
      {
        "price_per_bag": {
          "value": 41250,
          "currency": "USD",
          "decimal_places": 2,
          "display": "USD 412.50"
        },
        "total_price": {
          "value": 41250,
          "currency": "USD",
          "decimal_places": 2,
          "display": "USD 412.50"
        }
      }
    ],
    "extra_carry_on_options": [
      {
        "price_per_bag": {
          "value": 41250,
          "currency": "USD",
          "decimal_places": 2,
          "display": "USD 412.50"
        },
        "total_price": {
          "value": 41250,
          "currency": "USD",
          "decimal_places": 2,
          "display": "USD 412.50"
        }
      }
    ]
  },
  "fare_change_notice": {
    "original_brand": "MAIN SELECT",
    "new_brand": "MAIN CABIN"
  },
  "quote_id": "exch_7a1c93f0",
  "session_reference": "exch_7a1c93f0",
  "expires_at": "2026-06-01T13:04:56Z"
}

Changes

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