Cancel a booking#

Cancels the booking through the same durable machinery every other cancellation path in this system uses — the booking's status is flipped and its channel inventory released. This call never posts a ledger credit itself. The credit for the non-retained portion is posted asynchronously, once, when the resulting booking.cancelled lifecycle event is processed — polling GET .../cancellation-quote before and after cancelling will not show it land instantly. Cancelling an already-cancelled booking is a quiet no-op (alreadyCancelled: true on the response) — never a second cancellation, never a second credit. A booking belonging to another agent group is 404, identically to one that doesn't exist.

curl -X POST 'https://partner-api.elivaas.com/v1/bookings/{bookingId}/cancel' \
  -u "$ELIVAAS_API_KEY:" \
  -H 'Content-Type: application/json'

const res = await fetch('https://partner-api.elivaas.com/v1/bookings/{bookingId}/cancel', {
  method: 'POST',
  headers: {
    Authorization: 'Basic ' + Buffer.from(process.env.ELIVAAS_API_KEY + ':').toString('base64'),
    'Content-Type': 'application/json',
  },
});
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json();

import os, requests
res = requests.post(
    "https://partner-api.elivaas.com/v1/bookings/{bookingId}/cancel",
    auth=(os.environ["ELIVAAS_API_KEY"], ""),
    timeout=30,
)
res.raise_for_status()
data = res.json()

{
  "bookingId": "string",
  "bookingStatus": "string",
  "refundPercentage": 0,
  "refundedAmount": 0,
  "currency": "INR",
  "refundIds": [
    "string"
  ],
  "alreadyCancelled": true
}

Path parameters#

bookingIdstringrequired

No description in the spec.

Query parameters#

reasonstring

Optional free-text reason, kept for the audit log.

Responses#

See Errors for the error body shape and which statuses are worth retrying.