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>",
  "airline_penalty_paise": 123,
  "ota_fee_paise": 123,
  "refund_amount_paise": 123,
  "currency": "<string>",
  "quote_valid_until": "2023-11-07T05:31:56Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.travomatrix.com/llms.txt

Use this file to discover all available pages before exploring further.

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>