Skip to main content
POST
/
flight
/
booking
/
partial-cancel
/
quote
Get Partial Cancellation Quote
curl --request POST \
  --url https://api.travomatrix.com/api/v1/flight/booking/partial-cancel/quote \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "booking_id": "<string>",
  "passengers_to_cancel": [
    "<string>"
  ],
  "segments_to_cancel": [
    123
  ]
}
'
{
  "booking_id": "<string>",
  "processing_mode": "AUTO",
  "airline_penalty_paise": 123,
  "ota_fee_paise": 123,
  "refund_amount_paise": 123,
  "currency": "<string>",
  "quote_valid_until": "2023-11-07T05:31:56Z"
}
Calculate the refundable amount for cancelling specific passengers or flight segments while keeping the rest of the booking intact.

​
Supported Cancellation Scopes

The Travomatrix B2B backend abstracts the complexity of all GDS, NDC, and LCC providers into two primary partial cancellation scopes:
  1. Partial Pax: Cancel specific passengers (across all segments). Provide passengers_to_cancel and leave segments_to_cancel: [].
  2. Partial Segment: Cancel specific flight segments (for all passengers). Provide segments_to_cancel and leave passengers_to_cancel: [].
Note: Mixed cancellations (cancelling specific segments for specific passengers only) are currently restricted to prevent PNR desynchronization.

​
Key Business Rules

Our unified rules engine enforces the following constraints across all providers:
  • Infant Dependency: An infant (INF) cannot be cancelled alone, nor can all adults be cancelled if an infant remains on the booking.
  • Segment Sequence: Segments must be cancelled in reverse chronological order. You cannot cancel the outbound leg (e.g., Segment 0) while keeping the return leg (e.g., Segment 1). Doing so results in a segment_sequence_invalid error.

Authorizations

​
X-API-Key
string
header
required

Body

application/json
​
booking_id
string
required
​
passengers_to_cancel
string[]
required
​
segments_to_cancel
integer[]
required

Response

200 - application/json

Partial cancellation quote.

​
booking_id
string
​
processing_mode
enum<string>
Available options:
AUTO,
MANUAL
​
airline_penalty_paise
integer
​
ota_fee_paise
integer
​
refund_amount_paise
integer
​
currency
string
​
quote_valid_until
string<date-time>