TravelCaster API - Flights - GetFlightBookingNotifications operation

Back to Flights home.

You can retrieve updates on the bookings you have done over the TravelCaster API, such as ticketing details or flight schedule changes.

The GetFlightBookingNotifications operation returns a FlightBookingNotificationResponse object, containing an array of notifications. Each notification includes the GDS booking number, the type of update and details to it, with the exact date that update has happened. To call this operation you will need a valid token, obtained previously with the GetAccessToken operation. If your token is no longer valid, you will receive a 1210 error. See the Transaction Codes page for more information.

Request

JSON

http://endpoint/api/version/FlightService.json/GetFlightBookingNotifications [POST]

url-encoded parameter: request([FlightBookingNotificationRequest])

returns: FlightBookingNotificationResponse

WebService

http://endpoint/api/version/FlightService.asmx

operation: GetFlightBookingNotifications

parameters: request([FlightBookingNotificationRequest])

returns: FlightBookingNotificationResponse

Structure of the FlightBookingNotificationRequest object

All fields are required unless stated otherwise.

FlightBookingNotificationRequest
 |
 |_ Token (string)
 |_ BookingNumber (string - optional - GDS booking number as returned in the FlightBookingResponse)
 |_ Since (string - optional - Datetime in ISO 8601 YYYY-MM-DD HH:mm:ss format)

Structure of the FlightBookingNotificationResponse object

All fields are required unless stated otherwise.

FlightBookingNotificationResponse
 |
 |_ Token (string)
 |_ TransactionID (string)
 |_ TransactionCode (string)
 |_ TransactionMessage (string)
 |
 |_ Notifications (array)
    |_ BookingNumber (string)
    |_ StatusUpdate (string - type of update)
    |_ StatusText (string - detail on this update)
    |_ StatusDate (string - Datetime of this update in ISO Format YYYY-MM-DD HH:mm:ss)

Types of updates

TKTOK - The booking was ticketed successfully. In the status text you will find ticket numbers for all passengers.
TKTER - The booking could not be ticketed. In the status text you will find error details and/or any communication from the ticketing team.
XLED - The booking was cancelled. In the status text you will find cancellation details.

Notes

You can filter by BookingNumber, in case you want updates on a specific booking.
You can filter by UpdateDate as well. This allows you to check updates since a specific date. This paramenter is expected in the YYYY-MM-DD HH:mm:ss ISO-8061 format.

Go to the Samples page for more information on request/response.