Cancellation Status

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Cancellation Status API

The Cancellation Status API allows you to check the current status of a flight cancellation request. This endpoint helps you track whether your cancellation request has been processed, is pending, or requires further action.

API Endpoint

POST /flight/cancellation_status

Request Structure

The API requires the following parameters in the request body:

{
    "request_id": "320073",
    "client_referenceId": "WQGH376271"
}

Request Parameters

ParameterTypeRequiredDescription
request_idStringYesThe unique identifier for the cancellation request. This ID is returned when you initiate a cancellation request.
client_referenceIdStringYesYour unique client reference ID used to track the transaction on your end.

Response Structure

Upon successful execution, the API returns the following response:

{
    "status": "SUCCESS",
    "status_code": "200",
    "message": "Cancellation Status retrieved successfully.",
    "data": {
        "trace_id": "ef55669b-a8ab-4771-b057-94ac9b7452a8",
        "result": {
            "request_id": 320073,
            "ticket_id": 2263870,
            "request_status": "Unassigned"
        }
    }
}

Response Parameters

ParameterTypeDescription
statusStringOverall status of the API call (SUCCESS or FAILED)
status_codeStringHTTP status code of the response
messageStringDescriptive message about the API response
dataObjectContains the main response data
data.trace_idStringUnique trace identifier for tracking purposes
data.resultObjectContains the cancellation request details
data.result.request_idIntegerThe cancellation request ID
data.result.ticket_idIntegerThe associated ticket ID for the booking
data.result.request_statusStringCurrent status of the cancellation request

Request Status Values

The request_status field can have the following values:

  • Unassigned: The cancellation request has been received but not yet assigned for processing
  • In Progress: The cancellation request is currently being processed
  • Completed: The cancellation has been successfully processed
  • Failed: The cancellation request could not be processed
  • Cancelled: The cancellation request itself has been cancelled

Usage Notes

  • Use this API to periodically check the status of your cancellation requests
  • The request_id is essential for tracking and should be stored after initiating a cancellation
  • Response times may vary depending on airline processing times
  • Consider implementing appropriate retry logic with reasonable delays between status checks

Error Handling

If the API encounters an error, it will return appropriate error codes and messages. Common scenarios include:

  • Invalid request_id
  • Request not found
  • System unavailable

Always check the status field in the response to determine if the API call was successful before processing the data.

Body Params
string
required

Unique Client Reference ID

string
required
Headers
string
required
string
required
Response
200
Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here!