GOgojinko
Post-booking

DEPRECATED — use /v1/flight_refund_preview. Check refund eligibility only; use flight_refund_preview for customer-facing amounts

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

Request

  • Base URL
    https://api.gojinko.com
  • URL
    https://api.gojinko.com/v1/refund_check
  • 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.

Example request

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

Response

Check refund eligibility only; use flight_refund_preview for customer-facing amounts

is_refundableboolean

Whether the fare that was sold is refundable under its fare rules: the same answer the price check gave. A non-refundable ticket can still be given back in full while it is inside its void window; read is_voidable for that.

is_voidableboolean

True when committing would VOID the ticket outright — the document is still inside its void window, so the original charge is reversed in full instead of a fare-rule refund being computed. This check returns eligibility only; use flight_refund_preview for customer-facing amounts. Time-sensitive — read it from a live check, never from stored booking data.

is_automatableboolean
support_level'AUTO' | 'MANUAL_REQUIRED' | 'UNSUPPORTED'

How this action can be carried out. AUTO — the platform completes it end to end through the API. MANUAL_REQUIRED — it is possible, but a Jinko agent has to act; call the API to raise it and expect a delay rather than an immediate result. UNSUPPORTED — the provider or fare does not allow it at all; nothing you send will change that. Do not treat MANUAL_REQUIRED as a failure, and do not retry UNSUPPORTED. On the refund check manual_reason says why it is not AUTO, on the exchange shop reason.

manual_reasonstring

Why the refund is not automatic or not available, in words the customer can be shown; never the supplier’s wording. Present whenever support_level is not AUTO. With UNSUPPORTED it is the sentence a flight_refund_preview refusal (409 not_cancellable) carries for the same booking. With MANUAL_REQUIRED, where the reason would be the supplier’s own words, it reads “This request needs manual handling by Jinko support.”

reason_codestring

Why the refund is not automatic or not available, as a code to route on: NON_REFUNDABLE_FARE, EXCHANGED_TICKET, DOCUMENT_RETIRED, CARRIER_NOT_AUTHORIZED, NOT_CANCELLABLE (a refusal the supplier gave no code for). When support_level is UNSUPPORTED, it is always present and is the same code a flight_refund_preview refusal (409 not_cancellable) carries for this booking.

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

{
  "seat_refunds": [
    {
      "seat_number": "12B",
      "traveler_ref": "pax_1",
      "pax_ref_id": "pax_1",
      "amount": {
        "value": 41250,
        "currency": "USD",
        "decimal_places": 2,
        "display": "USD 412.50"
      },
      "carrier": "United",
      "message": "Your paid seat will be refunded once United refunds Jinko."
    }
  ],
  "is_refundable": true,
  "is_automatable": true,
  "manual_reason": "fare rules require agent review",
  "reason_code": "NON_REFUNDABLE_FARE",
  "expires_at": "2026-06-02T00:00:00Z"
}

Changes

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