Get Cancellation Charges

The Get Cancellation Charges API allows you to retrieve cancellation charges for flight bookings. This endpoint provides detailed information about charges, refund amounts, taxes, and per-passenger breakdown.

Endpoint

POST /flight/cancellation_charges

Headers

Header	Required	Description
`client-id`	Yes	Your unique client ID
`client-secret`	Yes	Your client secret key
`Content-Type`	Yes	`application/json`

Request Parameters

Parameter	Type	Required	Description
`client_referenceId`	string	Yes	Unique client reference ID for tracking the request
`booking_id`	integer	Yes	Unique ID for the booking you want to check cancellation charges for
`request_type`	string	Yes	Type of cancellation request. Allowed values: `full_cancellation` or `partial_cancellation`

Request Type Options

full_cancellation - Get charges for cancelling the entire booking
partial_cancellation - Get charges for cancelling specific passengers only

Example Request

{
    "client_referenceId": "WQGH762731",
    "booking_id": 1984869,
    "request_type": "full_cancellation"
}

Response Structure

Success Response

Field	Type	Description
`status`	string	Response status (`SUCCESS` or `FAILED`)
`status_code`	string	HTTP status code
`message`	string	Response message
`data`	object	Contains cancellation details

Data Object

Field	Type	Description
`trace_id`	string	Unique trace ID for this request
`result`	object	Contains detailed cancellation information

Result Object

Field	Type	Description
`cancellation_charges`	number	Total cancellation charges amount
`refund_amount`	number	Amount to be refunded after deducting charges
`currency`	string	Currency code (e.g., "INR")
`gst`	object	GST breakdown details
`cancellation_charges_details`	array	Per-passenger cancellation details

GST Object

Field	Type	Description
`cgst`	object	Central GST details with rate and amount
`igst`	object	Integrated GST details with rate and amount
`sgst`	object	State GST details with rate and amount
`cess`	object	Cess details with rate and amount
`taxable_amount`	number	Amount on which tax is calculated

Cancellation Charges Details Array

Each passenger object contains:

Field	Type	Description
`title`	string	Passenger title (Mr, Mrs, Ms, etc.)
`first_name`	string	Passenger's first name
`last_name`	string	Passenger's last name
`pax_type`	string	Passenger type (adult, child, infant)
`cancellation_charge`	number	Cancellation charge for this passenger
`refund_amount`	number	Refund amount for this passenger
`ticket_number`	string/null	Ticket number if available

Example Response

{
    "status": "SUCCESS",
    "status_code": "200",
    "message": "Cancellation Charges successfully retrieved.",
    "data": {
        "trace_id": "5c95feff-28e4-4f76-b563-2ceb8bd9e323",
        "result": {
            "cancellation_charges": 8280,
            "refund_amount": 1162,
            "currency": "INR",
            "gst": {
                "cgst": {
                    "cgst_rate": 0,
                    "cgst_amount": 0
                },
                "igst": {
                    "igst_rate": 18,
                    "igst_amount": 18
                },
                "sgst": {
                    "sgst_rate": 0,
                    "sgst_amount": 0
                },
                "cess": {
                    "cess_rate": 0,
                    "cess_amount": 0
                },
                "taxable_amount": 100
            },
            "cancellation_charges_details": [
                {
                    "title": "Mrs",
                    "first_name": "Payal",
                    "last_name": "Kumari",
                    "pax_type": "adult",
                    "cancellation_charge": 4140,
                    "refund_amount": 580.88,
                    "ticket_number": null
                }
            ]
        }
    }
}

Response Analysis

Understanding the Response

Total Charges: The cancellation_charges field shows the total amount that will be deducted
Refund Amount: The refund_amount shows what the customer will receive back
Tax Breakdown: The gst object provides detailed tax information including IGST at 18%
Per-Passenger Details: Each passenger's individual charges and refunds are listed separately

Key Points

All amounts are in the specified currency (INR in this example)
GST is calculated and displayed separately for transparency
Individual passenger details help in understanding charge distribution
The trace_id can be used for tracking and support purposes

Error Handling

In case of errors, the API will return appropriate HTTP status codes with error messages. Common scenarios include:

400 Bad Request: Invalid booking ID or request parameters
404 Not Found: Booking not found
500 Internal Server Error: System error occurred

Always check the status field in the response to determine if the request was successful.