TravelCaster API - Flights - GetBookingFareRules operation

Back to Flights home.

---

Use this transaction to query the fare rules which apply to an already booked flight. Some providers don't have this information. The request from this transaction is similar to the ConfirmFlightAvailability operation.

Request

JSON

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

url-encoded parameter: request([RetrieveBooking])

returns: FlightFareRuleResponse

WebService

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

operation: GetBookingFareRules

parameters: request([RetrieveBooking])

returns: FlightFareRuleResponse

Structure of the RetrieveBooking object

{
  "Token": "string",
  "BookingNumber": "string"
}

Structure of the GetFlightFareRulesResponse object

{
  "Token": "string",
  "TransactionID": "string",
  "Rules": [
    {
      "Category": "string",
      "Text": "string" //Fee text
    }
  ]
}

Notes

• This transaction is not available for all products.

Samples

Request

<RetrieveBookingRequest> 
  <Token>c875db864b5c1d00</Token>
  <BookingNumber>ABCDEF</BookingNumber>
</RetrieveBookingRequest>

Response

<FlightFareRuleResponse>
    <Token>c875db864b5c1d00</Token>
    <TransactionID>fdb4344eb1fc3700</TransactionID>
    <Rules>
       <FlightFareRule>
          <Category>05 - ADVANCE RESERVATIONS/TICKETING</Category>
          <Text>RESERVATIONS ARE REQUIRED FOR EACH SECTOR. WHEN RESERVATIONS ARE MADE AT LEAST 15 DAYS BEFORE DEPARTURE, [...]TICKETING ON EACH TRIP MUST BE COMPLETED WITHIN 24 HOURS AFTER RESERVATIONS ARE MADE.</Text>
       </FlightFareRule>
       <FlightFareRule>
          <Category>06 - MINIMUM STAY</Category>
          <Text>NO MINIMUM STAY REQUIREMENTS APPLY.</Text>
       </FlightFareRule>
       <FlightFareRule>
          <Category>07 - MAXIMUM STAY</Category>
          <Text>TRAVEL FROM LAST STOPOVER MUST COMMENCE NO LATER THAN 12 MONTHS AFTER DEPARTURE FROM FARE ORIGIN.</Text>
       </FlightFareRule>
       <FlightFareRule>
          <Category>15 - SALES RESTRICTIONS</Category>
          <Text>TICKETS MAY NOT BE SOLD IN VENEZUELA.</Text>
       </FlightFareRule>
       <FlightFareRule>
          <Category>16 - PENALTIES</Category>
          <Text>CHANGES ANY TIME CHANGES PERMITTED FOR REISSUE/REVALIDATION. ANY TIME CHARGE USD 50.00 FOR NO-SHOW...</Text>
       </FlightFareRule>
       <FlightFareRule>
          <Category>31 - VOLUNTARY CHANGES</Category>
          <Text>IN THE EVENT OF CHANGES TO TICKETED FLIGHTS BEFORE DEPARTURE OF JOURNEY AND WITHIN TICKET VALIDITY </Text>
       </FlightFareRule>
       <FlightFareRule>
          <Category>33 - VOLUNTARY REFUNDS</Category>
          <Text>CHECK CATEGORY 16 OR CONTACT CARRIER FOR DETAILS.</Text>
       </FlightFareRule>
    </Rules>
 </FlightFareRuleResponse>

---

Back to Flights home.