TravelCaster API - Flights - GetFareRules operation

Back to Flights home.

Use this transaction to query the fare rules which apply to a selected fare. 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/GetFlightFareRules [POST]

url-encoded parameter: request([request])

returns: FlightFareRuleResponse

WebService

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

operation: GetFlightFareRules

parameters: FlightFareRuleRequest([request])

returns: FlightFareRuleResponse

Structure of the GetFlightFareRules object

{
  "Token": "string",
  "RecommendationID": "string",
  "FareID": "string",
  "OptionID": [ //one for each leg you requested)
    "string",
    "string"
  ]
}

Structure of the GetFlightFareRulesResponse object

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

Notes

  • Be sure to include all required IDs: this operation checks the request for one RecommendationID, one FareID and one OptionID for each leg you queried. One-way queries will have one OptionID, round-trip ones will have two.
  • This transaction is not available for all products.

Samples

Request

<FlightFareRuleRequest> 
    <Token>c875db864b5c1d00</Token>
    <RecommendationID>7d210683250988b0</RecommendationID>
    <FareID>18517d433763aa90</FareID>
    <OptionID>
       <string>7dae1e5666fd2a90</string>
    </OptionID>
</FlightFareRuleRequest>

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.

See change history for this file
Loading...