TravelCaster API - Flights - BookExtraServices operation

Back to Flights home.

After you book a flight, you can book additional extra services. If the operation succeeds, the API will return the updated booking as a FlightRetrieveResponse object.

The BookExtraServices operation uses the FlightBookExtraServicesRequest request type as outlined below. As opposed to BookFlight, this operation will abort unless all requested extra services are available.

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/BookExtraServices [POST]

url-encoded parameter: booking([FlightBookExtraServicesRequest])

returns: FlightRetrieveResponse

WebService

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

operation: BookExtraServices

parameters: request ([FlightBookExtraServicesRequest])

returns: FlightRetrieveResponse

Structure of the FlightBookingRequest object

FlightBookExtraServicesRequest (inherits APITransaction)
 |
 |_ Token (string)
 |_ TransactionID (string)
 |_ TransactionMessage (string)
 |_ TransactionCode (string)
 |
 |_ BookingNumber (string)
 |_ RequestedAncilliaries (RequestedAncillary[])
       |
       |_ OfferType (string - according to the catalog, E.G. XBAG/SEAT)
       |_ OfferData (string - additional data required for the booking, if received in the FareConfirmation operation)
       |_ PassengerNumber (int)
       |_ SegmentNumbers (int[])
       |_ Quantity (string - at the moment you can only request 1 extra bag, so indicate "1" as value)
       |_ SeatRowColumn (string - seat number, concatenates seat row and seat column, e.g. "12A")
       |_ ExpectedTotalPrice (decimal - for the requested quantity, in the same currency as the booking fare)

Response time

Some providers can take up to 60 seconds to respond to an extra services booking request.

Structure of the FlightSeatMapResponse object

Notes

  • Dates sent to and from the API are all string-based and in the YYYY-MM-DD ISO-8061 format.

Transaction status

  • TransactionCode: 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 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.

See change history for this file
Loading...