VerticalAPI

Flights Fare Rule

This method is used to get the fare rules and condition of a specific flight option. It contains the fare basis code and the relevant details associated with it, such as restrictions and penalties(cancellation fees).

Parameters

Name

Description

Accept

string

( header )

Must be application/json

Accept - Encoding

string

( header )

Must be gzip

Authorization

string

( header )

Must be Your PID

Must be Your API Key

Customer-Ip

string

( header )

Must be IP address of the customer, as captured by your integration. Send IPV4 addresses only.

Ensure your integration passes the customer’s IP, not your own. This value helps determine their location and other settings.

Also used for fraud recovery and other important analytics.

Definition and request parameters for flight farerule

action

string

( query )

Must be "fareRule" as parameter

Action methods in Web API controller can have one or more parameters of different types. It can be either primitive type or complex type. Web API binds action method parameters either with URL's query string or with request body depending on the parameter type.

ModeType

string

( query )

Must be either "Test" or "LIVE"

Your application must be approved from Adivaha Personnel. All the transactions will be treated as LIVE once the parameter is set to LIVE.

ResultIndex

string

( query )

Result Index ie. "OB1"

TraceId

string

( query )

Trace Id (Get Trace Id from search response)

REQUEST

API Endpoint: https://your-end-point/api/v1/travel-api/flights/

header: array(
'Content-Type:application/json',
'Accept-encoding: gzip',
'PID:'ADD-YOUR-KEY',
'x-api-key:'ADD-YOUR-KEY'
);

POST:
{
  "action": "fareRule",
  "mode": "Test",
  "ResultIndex": "OB1",
  "TraceId": "da0b789a-f1c7-43dd-bcda-772890fe6edd"
}
					 

Response

The API returns an HTTP response, which generally includes the result of the request invocation

{
  "status": "200",
  "status_message": "OK",
  "responseData": {
    "Response": {
      "Error": {
        "ErrorCode": 0,
        "ErrorMessage": ""
      },
      "FareRules": [
        {
          "Airline": "AI",
          "DepartureTime": "2021-09-09T07:15:00",
          "Destination": "JAI",
          "FareBasisCode": "EIP9I",
          "FareRestriction": "",
          "FareRuleDetail": "Category- 16
Details:-
PENALTIES\nWITHIN INDIA FOR E-9I TYPE FARES\n CHANGES/CANCELLATIONS\n BEFORE DEPARTURE\n PER COUPON CHARGE INR 3000 FOR CANCEL/REISSUE/\n REVALIDATION.\n NOTE -\n FIRST CHANGE FREE FOR TICKETS ISSUED FOR TRAVEL\n ON OR BEFORE 31 MAY 2021 TILL EXISTING TICKET\n VALIDITY FOR 9I OPERATED FLTS ONLY\n REISSUANCE FOR FIRST FREE CHANGE ONLY\n PERMITTED BY AI ATO/CTO/GDS AND AI CALL CENTRE.\n IN CASE OF CHANGE TO HIGHER RBD FOR TRAVEL\n RE-ISSUANCE FEE WILL NOT BE APPLICABLE. ONLY\n DIFFERENCE IN TOTAL FARE IS TO BE COLLECTED.\n DOWNSELLING IS NOT ALLOWED\n -------------------------------------------------\n TEXT BELOW NOT VALIDATED FOR AUTOPRICING.\n RE-ISSUANCE / RE-VALIDATION / CANCELLATION FEE -\n INR 3000 OR BASIC FARE WHICH EVER IS LOWER TILL\n 24 HR BEFORE DEP. NOT PERMITTED LESS\n THAN 24 HOURS BEFORE DEPARTURE.\n --------------------------------------------------\n THE CHANGE/REISSUE CHARGE IS NON - REFUNDABLE\n --------------------------------------------------\n NO RE-VALIDATION OR CANCELLATION FEE WOULD BE APPL\n ICABLE ON INFANT TICKETS.\n --------------------------------------------------\n CANCELLATION FEE OF PARTLY USED TICKET\n DEDUCT ONEWAY FARE AND LEVIES FOR THE TRAVELLED\n SECTOR PLUS CANCELLATION FEE.\n --------------------------------------------------\n IN CASE OF CHANGE TO HIGHER RBD FOR TRAVEL ON THE\n SAME DAY/SAME FLIGHT/RE-ISSUANCE FEE WILL NOT BE\n APPLICABLE.ONLY DIFFERENCE IN TOTAL FARE IS TO BE\n COLLECTED.\n --------------------------------------------------\n FOR WAIVER OF PENALTY ON ACCOUNT OF DEATH OF\n PASSENGER OR IMMEDIATE FAMILY MEMBER PLS REFER\n LAST PAGE\n --------------------------------------------------\n RESERVATIONS BOOKED MORE THAN 7 DAYS PRIOR TO\n COMMENCEMENT OF TRAVEL MAY BE CANCELLED OR\n AMENDED WITHIN 24 HOURS OF BOOKING TICKET WITHOUT\n PENALTY.RESERVATIONS BOOKED WITHIN 7 DAYS OF\n COMMENCEMENT OF TRAVEL ARE SUBJECT TO THE\n APPLICABLE CANCELLATION PENALTY.\n CHANGES/CANCELLATIONS PERMITTED FOR NO-SHOW.\n NOTE -\n TEXT BELOW NOT VALIDATED FOR AUTOPRICING.\n CHANGES / CANCELLATION FEE IF CANCELLED\n LESS THAN 24 HOUR BEFORE DEPARTURE - 100 PERCENT\n OF BASIC FARE WILL BE FORFEITED.\n --------------------------------------------------\n THE CHANGE/REISSUE CHARGE IS NON - REFUNDABLE\n --------------------------------------------------\n CHARGES ARE NON-COMMISISONABLE. APPLICABLE GST\n WILL BE ADDITIONAL.\n --------------------------------------------------\n AIR INDIA NO-SHOW WAIVER AT AIRPORT - FOR RBDS -\n H/K/Q/V/W/G/L/U/T/S/E IN CASE THE PASSENGER HAS\n REPORTED AT THE AIRPORT AFTER CLOSURE OF COUNTER\n BUT BEFORE DEPARTURE OF FLIGHT WOULD BE PERMITTED\n TO ROLL OVER ON NO-SHOW AT A CHARGE OF INR 3500.\n --------------------------------------------------\n THIS WILL BE AUTHORISED AT THE AIRPORT AT THE\n TIME OF FLIGHT ONLY AND CANNOT BE LEVIED/ WAIVED\n AT CBO.\n --------------------------------------------------\n THE WAIVER OF NO-SHOW IN SUCH CASES TO BE\n AUTHORISED BY THE DUTY MANAGER.\n --------------------------------------------------\n FURTHER FARE DIFFERENCE IF ANY AS PER THE RBD /\n FARE BASIS AVAILABLE / APPLICABLE ON THE NEXT\n AVAILABLE FLIGHT WILL HAVE TO BE CHARGED FROM THE\n PASSENGER IN ADDITION TO THE ROLL-OVER CHARGE.\n --------------------------------------------------\n FOR WAIVER OF PENALTY ON ACCOUNT OF DEATH OF\n PASSENGER OR IMMEDIATE FAMILY MEMBER PLS REFER\n LAST PAGE\n NOTE -\n IN CASE OF DEATH OF A PASSENGER OR IMMEDIATE\n FAMILY MEMBER BEFORE COMMENCEMENT OF TRAVEL\n PENALTY CHARGES STAND WAIVED OFF. THE ABOVE IS\n APPLICABLE ONLY WHEN TICKET IS PURCHASED BEFORE\n DEATH OF PASSENGER OR IMMEDIATE FAMILY MEMBER IS\n OCCURRED.\n -------------------------------------------------\n IMMEDIATE FAMILY SHALL BE LIMITED TO SPOUSE\n CHILDREN INCLUDING ADOPTED CHILDREN PARENTS\n BROTHERS SISTERS GRAND-PARENTS GRANDCHILDREN FA\n FATHER IN LAW MOTHER IN LAW SISTER IN LAW BROTHER\n IN LAW SON IN LAW AND DAUGHTER IN LAW\n -----------------------------------------------\n IN CASE OF DEATH OF A PASSENGER OR IMMEDIATE\n FAMILY MEMBER OCCURRED AFTER COMMENCEMENT OF\n TRAVEL PENALTY CHARGES STAND WAIVED OFF.\n -------------------------------------------------\n IN CASE OF DEATH OF PASSENGER OCCURRED AFTER\n COMMENCEMENT OF TRAVEL ACCOMPANYING PASSENGER MAY\n TERMINATE TRAVEL OR INTERRUPT TRAVEL UNTIL\n COMPLETION OF FORMALITIES AND RELIGIOUS CUSTOMS\n IF ANY BUT IN NO EVENT LATER THAN FORTY FIVE 45\n DAYS AFTER TRAVEL IS INTERRUPTED. THE TICKET OF\n RETURNING PASSENGERS WILL BE ENDORSED RETURN\n ACCOUNT DEATH NAME AND SUCH ENDORSEMENT SHALL BE\n AUTHENTICATED BY VALIDATION OR OTHER DUTY MANAGER\n OFFICIAL STAMP. REFUND MAY BE ARRANGED. RE-\n ROUTING MAY BE PERMITTED APPLICABLE PENALTY IF\n ANY MAY BE WAIVED. DIFFERENCE OF FARE NEEDS TO BE\n COLLECTED.\n ----------------------------------------------\n FOR RETURN-ONWARD TICKER REFUND DEDUCT ONE WAY\n FARE AND LEVIES FOR THE TRAVELLED SECTOR AND\n BALANCE AMOUNT MAY BE REFUNDED.\n -----------------------------------------------\n PENALTY ON ABOVE ACCOUNT IS WAIVED FOR FIRST\n TRANSACTION ONLY. SUBSEQUENT TRANSACTION IF ANY\n WILL ATTRACT APPLICABLE PENALTY.
Category- 31
Details:-
VOLUNTARY CHANGES\nDO A CATEGORY 31 SPECIFIC TEXT ENTRY TO VIEW CONTENTS\nALSO REFERENCE 16 PENALTIES - FOR ADDITIONAL CHANGE INFORMATION
Category- 33
Details:-
VOLUNTARY REFUNDS\nFOR E-9I TYPE FARES\n APPLIES IN THE CASE OF DEATH OF PASSENGER OR FAMILY\n MEMBER.\n REFUND MAY BE REQUESTED ANYTIME.\n NO CHARGE. IF ALL PENALTIES IN PRICING UNIT ARE PER FARE\n COMPONENT COLLECT EACH. IF MIX OF PER FARE COMPONENT AND\n PER PRICING UNIT CALCULATE EACH AS PER PRICING UNIT AND\n COLLECT HIGHEST.\n FORM OF REFUND - ORIGINAL FORM OF PAYMENT. ONLY VALIDATING\n CARRIER MAY REFUND TICKET.\n REPRICE FLOWN PORTION USING FARES IN EFFECT ON TICKET\n ISSUANCE DATE. FOR FULLY FLOWN FARE COMPONENTS FARE BREAK\n POINTS MAY NOT BE CHANGED. FOR PARTIALLY FLOWN FARE\n COMPONENTS ONLY DESTINATION FARE BREAK POINTS MAY BE\n CHANGED. REPRICE USING NORMAL/SPECIAL ONE WAY/ROUND TRIP\n FARES/ANY RULE/FARE CLASS/EQUAL OR HIGHER RBD. PUBLIC\n FARES ARE USED IF TICKETED FARE IS IN PUBLIC TARIFF.\n QUALIFIED PRIVATE FARES OR PUBLIC FARES ARE USED IF\n TICKETED FARE IS IN PRIVATE TARIFF. NEW FARE FOR FULLY\n FLOWN FARE COMPONENTS MUST BE EQUAL TO OR HIGHER THAN\n TICKETED FARE.\n OR -\n VALID FOR INFANT WITHOUT A SEAT.\n REFUND MAY BE REQUESTED ANYTIME.\n NO CHARGE. IF ALL PENALTIES IN PRICING UNIT ARE PER FARE\n COMPONENT COLLECT EACH. IF MIX OF PER FARE COMPONENT AND\n PER PRICING UNIT CALCULATE EACH AS PER PRICING UNIT AND\n COLLECT HIGHEST. NO CHARGE FOR INFANT WITHOUT SEAT.\n FORM OF REFUND - ORIGINAL FORM OF PAYMENT. ONLY VALIDATING\n CARRIER MAY REFUND TICKET.\n REPRICE FLOWN PORTION USING FARES IN EFFECT ON TICKET\n ISSUANCE DATE. FOR FULLY FLOWN FARE COMPONENTS FARE BREAK\n POINTS MAY NOT BE CHANGED. FOR PARTIALLY FLOWN FARE\n COMPONENTS ONLY DESTINATION FARE BREAK POINTS MAY BE\n CHANGED. REPRICE USING NORMAL/SPECIAL ONE WAY/ROUND TRIP\n FARES/ANY RULE/FARE CLASS/EQUAL OR HIGHER RBD. PUBLIC\n FARES ARE USED IF TICKETED FARE IS IN PUBLIC TARIFF.\n QUALIFIED PRIVATE FARES OR PUBLIC FARES ARE USED IF\n TICKETED FARE IS IN PRIVATE TARIFF. NEW FARE FOR FULLY\n FLOWN FARE COMPONENTS MUST BE EQUAL TO OR HIGHER THAN\n TICKETED FARE.\n REFUND REQUEST REQUIRED 24 HOURS BEFORE ORIGINALLY\n SCHEDULED FLIGHT OF FIRST UNUSED TICKET COUPON.\n CHARGE INR 3150 PER FARE COMPONENT. IF ALL PENALTIES IN\n PRICING UNIT ARE PER FARE COMPONENT COLLECT EACH. IF MIX\n OF PER FARE COMPONENT AND PER PRICING UNIT CALCULATE EACH\n AS PER PRICING UNIT AND COLLECT HIGHEST. NO CHARGE FOR\n INFANT WITHOUT SEAT.\n FORM OF REFUND - ORIGINAL FORM OF PAYMENT. ONLY VALIDATING\n CARRIER MAY REFUND TICKET.\n REPRICE FLOWN PORTION USING FARES IN EFFECT ON TICKET\n ISSUANCE DATE. FOR FULLY FLOWN FARE COMPONENTS FARE BREAK\n POINTS MAY NOT BE CHANGED. FOR PARTIALLY FLOWN FARE\n COMPONENTS ONLY DESTINATION FARE BREAK POINTS MAY BE\n CHANGED. REPRICE USING NORMAL/SPECIAL ONE WAY/ROUND TRIP\n FARES/ANY RULE/FARE CLASS/EQUAL OR HIGHER RBD. PUBLIC\n FARES ARE USED IF TICKETED FARE IS IN PUBLIC TARIFF.\n QUALIFIED PRIVATE FARES OR PUBLIC FARES ARE USED IF\n TICKETED FARE IS IN PRIVATE TARIFF. NEW FARE FOR FULLY\n FLOWN FARE COMPONENTS MUST BE EQUAL TO OR HIGHER THAN\n TICKETED FARE.\n OR -\n FARE IS NONREFUNDABLE BEFORE ORIGINALLY SCHEDULED FLIGHT\n OF FIRST UNUSED TICKET COUPON.\n IF MIX OF PER FARE COMPONENT AND PER PRICING UNIT\n CALCULATE EACH AS PER PRICING UNIT AND COLLECT HIGHEST.\n REPRICE USING EQUAL OR HIGHER RBD.\n OR -\n FARE IS NONREFUNDABLE ANYTIME AFTER ORIGINALLY SCHEDULED\n FLIGHT OF FIRST UNUSED TICKET COUPON.\n IF MIX OF PER FARE COMPONENT AND PER PRICING UNIT\n CALCULATE EACH AS PER PRICING UNIT AND COLLECT HIGHEST.\n REPRICE USING EQUAL OR HIGHER RBD.

", "FlightId": 0, "Origin": "DEL", "ReturnDate": "2021-09-09T08:15:00" } ], "ResponseStatus": 1, "TraceId": "da0b789a-f1c7-43dd-bcda-772890fe6edd", "PenaltyCharges": { "ReissueCharge": "3000 INR", "CancellationCharge": "3000 INR" } } } }