Skip to main content
POST
Cancel a car rental booking
Cancel the booking at the rental provider and refund the customer’s payment minus the cancellation fee. Requires the cancellation_id from a preceding preview, binding the commit to the fee the customer saw. Safe to call twice, a committed cancellation is reported as it stands rather than repeated. refund_pending_review: true means the booking is cancelled but the refund needs manual review before it is issued.

Authorizations

X-API-Key
string
header
required

Body

application/json
booking_ref
string
required

Jinko booking reference from the confirmation email.

Minimum string length: 1
Example:

"JNK-8PT9VS"

last_name
string
required

Lead traveler's last name, exactly as on the booking.

Minimum string length: 1
Example:

"Carrard"

cancellation_id
string
required

The "ccl_…" reference from a preceding car_cancel_preview. Binds the commit to the fee the customer saw.

Minimum string length: 1
Example:

"ccl_2f7c9a4e8b1d4c6f9e3a5b7d1c2e4f6a"

intent
object
reason
string

Optional free-text cancellation reason.

Example:

"Change of plans"

Response

Cancellation result

cancellation_id
string
Example:

"ccl_2f7c9a4e8b1d4c6f9e3a5b7d1c2e4f6a"

state
string
Example:

"confirmed"

fee_known
boolean
fee
object

The only amount Jinko charges at checkout.

paid
object

The only amount Jinko charges at checkout.

refund_amount
object

The only amount Jinko charges at checkout.

refund_pending_review
boolean

true means the booking IS cancelled but the refund needs manual review before it is issued.

stripe_refund_id
string
rejected_reason
string
completed_at
string
Example:

"2026-08-20T15:18:00Z"