TravelCaster API - Flights - Transactions list
Back to Flights home.
Authentication
To connect to the API you will need a username and a password. The API provides you with two passwords, one for the development environment and one for the production one. Depending on the password you send with your credentials, you will access one environment or the other.
Important notice: the following indications assume you have a username and password given by a TravelCaster partner. If not, please contact your TravelCaster partner and request your access.
API operations
The API gateway has the following operations:
- GetAccessToken - returns a transaction token for a username/password combination. This token is used in all messages to the gateway
- GetFlightAvailability - returns flight fares matching a flight availability query
- GetFlightFareRules - query the fare rules from a selected fare
- GetFareOptions - query alternative fare options from a given fare returned by the flight availability operation
- ConfirmFlightAvailability - confirms bookability of a combination of flight options for a given fare
- GetSeatMap - (1.6 only) returns the seat map for a quoted itinerary
- BookFlight - books an array of previously confirmed flight options for a given fare and returns a booking number
- UpdateBookingPayments - update payment methods on a booking
- ChangeFlightBookingStatus - requests ticketing or cancellation for a given booking
- RetrieveBooking - retrieve a booked flight, returns updated flight information, buyer and notifications
- RePriceBooking - (1.7 only) re-prices an existing confirmed booking and optionally updates its payment amount
- GetBookingFareRules - query the fare rules for a given booking
- GetSeatMapForBooking - (1.6 only) returns the seat map for a given booking
- BookExtraServices - (1.6 only) add extra services to a given booking
- ListBookings - list all your bookings
- IssueBooking - issue/ticket an existing confirmed booking on demand
- UpdateBookingExternalID - (1.6 only) update the external id on a booking
- AddBookingInfo - (1.6 only) adds (or updates) additional information on the booking
- ImportExternalBooking - imports a booking made outside TravelCaster (by record locator) into the TravelCaster system
Structure of any API message
Any gateway message (with the exception of the GetAccessToken operation) has a common structure to straighten the path for your implementation and provide you with an easy way to test it and diagnose any issues you may encounter.
Each request or response object is different, but they have these fields in common:
- Token - the token returned in the GetAccessToken call for a username/password combo. You must include the token on each call you make to the API. The same token is returned on the response message for conversation validation purposes. See the GetAccessToken page for more information about the token.
- TransactionID - a unique string corresponding to the resulting transaction. It has no relevant information about the response, but in case you run into any issue with the API, you have to supply it to the API support team to be able to trace and detect the issue and provide you with a solution.
- TransactionCode - the result code for the current transaction. When a transaction had no errors, a null value will be returned. Any value different than null means something went wrong in the API. See the Transaction Codes page for a list of possible codes.
- TransactionMessage - the result message for the current transaction. Depending on the transaction, it could provide you a more granular error description that the one from the TransactionCode by itself.
Back to Flights home.