Cars

Check the status of a car rental cancellation

Report the latest cancellation attempt for the booking, whatever state it reached — including refund_pending_review, where the booking is cancelled but the refund awaits a human. Read-only. A 404 means either an unknown booking_ref + last_name pair or that no cancellation attempt exists yet for this booking — run car_cancel_preview first.

post/v1/car_cancel_status

Request

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

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.

Example request

{
  "booking_ref": "JNK-8PT9VS",
  "last_name": "Doe"
}

Response

Latest cancellation state

quote_idstring

The quote this cancellation was committed against.

cancellation_idstring

Deprecated: use quote_id instead. Same value.

statestring

The same words as car_cancel_commit: preview (quoted, never committed), pending (recorded, not finished — the platform or a Jinko agent still has it), confirmed, rejected, failed.

fee_knownboolean

refund_pending_reviewboolean

stripe_refund_idstring

Deprecated. An internal payment reference.

rejected_reasonstring

Example response

{
  "quote_id": "ccl_2f7c9a4e8b1d4c6f9e3a5b7d1c2e4f6a",
  "cancellation_id": "ccl_2f7c9a4e8b1d4c6f9e3a5b7d1c2e4f6a",
  "state": "confirmed",
  "fee": {
    "value": 41250,
    "currency": "EUR",
    "decimal_places": 2,
    "display": "EUR 412.50"
  },
  "paid": {
    "value": 41250,
    "currency": "EUR",
    "decimal_places": 2,
    "display": "EUR 412.50"
  },
  "refund_amount": {
    "value": 41250,
    "currency": "EUR",
    "decimal_places": 2,
    "display": "EUR 412.50"
  }
}

Changes

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