FARE QUOTE
This method is required to re-price the selected itinerary. This is required to make sure that we have the updated price including tax because in some cases, the fare provided at the time of search may change.
The Confirm Fare request depends on the Search Result, and it can be categorized into two main scenarios:
1. Single Result Case
* This occurs in one-way itineraries or in most cases of international return itineraries.
* For one-way searches, only a single result is returned.
* In international return searches, typically (≈99% cases) a single ResultIndex is returned that already contains all possible onward/return combinations.
* In this scenario, the system simply passes the selected ResultIndex directly in the Confirm Fare request.
2. Multiple Result Case (Return with Separate Fares)
* In some return itineraries, separate fares are returned for onward and return segments, resulting in two different ResultIndex values.
* The customer selects the desired onward and return combination, and the total fare is calculated accordingly.
* In such cases, Confirm Fare must handle the request based on the SingleSlotBooking flag:
a. Condition 1 – SingleSlotBooking = "No"
* The booking cannot be completed in a single request.
* Confirm Fare must be performed separately for each ResultIndex (once for onward and once for return), similar to handling two one-way bookings.
b. Condition 2 – SingleSlotBooking = "Yes"
* The booking can be confirmed in a single request.
* Both ResultIndex values must be sent comma-separated in the Confirm Fare request.
* Example: If the onward result index is TTSS0 and the return result index is YYDSI, the request must include:
ResultIndex="TTSS0,YYDSI"
If the FareType is received as SpecialReturn, a tag called ReturnIdentifierMatched will also be provided.
* If this tag contains a value, the same value must be used for both OB (Onward) and IB (Inbound) ResultIndex in the FareQuote request.
Service URL (REST) to be used:
Fare Quote Request
| Level | Element | Format | Comments | Mandatory |
|---|---|---|---|---|
| 1 | EndUserIp | String | Public IP address of the end user initiating the flight search request. Used for security, tracking, and compliance purposes. | Mandatory |
| 2 | ClientId | String | Unique client identifier assigned to the agency during API registration and onboarding. | Mandatory |
| 3 | UserName | String | API username assigned to the agency for authentication and authorization. | Mandatory |
| 4 | Password | String | API password assigned to the agency for authentication. This credential must be transmitted securely. | Mandatory |
| 5 | SrdvType | String | Response type identifier indicating the version or category of data returned by the SRDV system. | Mandatory |
| 6 | TraceId | Integer | Trace ID returned in the search response. This value must be echoed back in subsequent requests and can be used to trace a specific search or booking within the SRDV system. | Mandatory |
| 7 | SrdvIndex | String | Unique SRDV reference identifier associated with the selected flight result. Required for subsequent operations such as fare validation, booking, and ticket issuance. | Mandatory |
| 8 | ResultIndex | String | Unique identifier of the selected flight result returned in the search response. This value is required for Fare Quote, Booking, and other follow-up API operations. | Mandatory |
Fare Quote Response
| Level | Element | Format | Comments | Mandatory |
|---|---|---|---|---|
| 1 | Error{} | Object | Contains error details returned by the API when the request cannot be processed successfully. | Mandatory |
| 1.1 | ErrorCode | String | Unique error code identifying the type of error encountered during request processing. | Mandatory |
| 1.2 | ErrorMessage | String | Human-readable description of the error returned by the API. | Mandatory |
| 2 | TraceId | Integer | Unique identifier assigned to the API request for tracking, debugging, and support purposes. | Mandatory |
| 3 | SrdvType | String | Response type identifier indicating the version or category of data returned by the SRDV system. | Mandatory |
| 4 | IsPriceChanged | Boolean | Indicates whether the fare has changed since the last fare validation. Possible (Value – True or False) | Mandatory |
| 5 | Results{} | Object | Contains fare details, pricing information, passenger requirements, and flight segment information for the selected itinerary. | Mandatory |
| 5.1 | SrdvIndex | String | Unique SRDV reference identifier associated with the selected flight result. Required for subsequent operations such as fare validation, booking, and ticket issuance. | Mandatory |
| 5.2 | ResultIndex | String | Unique identifier of the selected flight result returned in the search response. This value is required for Fare Quote, Booking, and other follow-up API operations. | Mandatory |
| 5.3 | Source | String | Source or provider from which the fare is retrieved. | Mandatory |
| 5.4 | ButtonColor | String | Hex color code used for displaying the fare option button. | Mandatory |
| 5.5 | TextColor | String | Hex color code used for displaying text associated with the fare option. | Mandatory |
| 5.6 | SingleSlotBooking | Enumeration | Indicates whether the flight supports booking all passengers under a single booking slot. | Mandatory |
| 5.7 | IsLCC | Boolean | Indicates whether the airline is a Low-Cost Carrier (LCC). (Value – True or False) | Mandatory |
| 5.8 | IsRefundable | Boolean | Indicates whether the ticket is eligible for cancellation and refund as per airline rules. (Value – True or False) | Mandatory |
| 5.9 | IsPriceChanged | Boolean | Indicates whether the fare has changed since the last fare validation. Possible values( Value – True or False ) | Mandatory |
| 5.10 | AirlineRemarks | String | Additional remarks or instructions provided by the airline for the selected itinerary. | Optional |
| 5.11 | IsPassportRequiredAtBook | Boolean | If True, passport details must be provided during booking. For international segments, passport details are always mandatory. | Optional |
| 5.12 | IsPassportFullDetailRequiredAtBook | Boolean | If True, you need to pass the passport issue country and passport issue date. | Optional |
| 5.13 | IsPassportExpiryRequired | Boolean | If True, you need to pass the passport expiry date. | Optional |
| 5.14 | IsPassportIssueDateRequired | Boolean | If True, you need to pass the passport issue date. | Optional |
| 5.15 | GSTAllowed | Boolean | Indicates whether GST details can be submitted for the booking. | Optional |
| 5.16 | IsGSTMandatory | Boolean | Indicates whether GST details are mandatory for completing the booking. | Optional |
| 5.17 | AdultDobRequired | Boolean | Indicates whether the Date of Birth is required for adult passengers. | Optional |
| 5.18 | ChildDobRequired | Boolean | Indicates whether the Date of Birth is required for child passengers. | Optional |
| 5.19 | InfantDobRequired | Boolean | Indicates whether the Date of Birth is required for infant passengers. | Optional |
| 5.20 | SeatSelectAllowed | Boolean | Indicates whether seat selection is available for the itinerary. | Optional |
| 5.21 | HoldAllowed | Boolean | Indicates whether the booking can be placed on hold before ticket issuance. | Optional |
| 5.22 | Fare{} | Object | Detailed fare breakdown for the selected flight. | Mandatory |
| 5.22.1 | Currency | String | Currency code in which all fare amounts are displayed (e.g., INR, USD). | Mandatory |
| 5.22.2 | BaseFare | Decimal | Base ticket fare before taxes, fees, and surcharges. | Mandatory |
| 5.22.3 | Tax | Decimal | Total tax amount applicable to the booking. | Mandatory |
| 5.22.4 | YQTax | Decimal | Fuel surcharge imposed by the airline. Included in the total tax amount. | Mandatory |
| 5.22.5 | OtherCharges | Decimal | Additional charges imposed by the airline, airport, or regulatory authorities. | Mandatory |
| 5.22.6 | TransactionFee | Decimal | Transaction or processing fee applicable to the booking. | Mandatory |
| 5.22.7 | AdditionalTxnFeeOfrd | Decimal | Additional transaction fee included in the offered fare. This amount may be collected from the customer but is not charged by SRDV. | Mandatory |
| 5.22.8 | AdditionalTxnFeePub | Decimal | Additional transaction fee included in the published fare. This amount may be collected from the customer but is not charged by SRDV. | Mandatory |
| 5.22.9 | AirTransFee | Decimal | Airline transaction fee applicable to the booking. | Mandatory |
| 5.22.10 | Discount | Decimal | Total discount applied to the fare. Typically zero for API customers. | Mandatory |
| 5.22.11 | PublishedFare | Decimal | Total fare published by the airline, including base fare, taxes, and applicable charges. | Mandatory |
| 5.22.12 | OfferedFare | Decimal | Final fare offered to the customer after applying all applicable fare adjustments, charges, and markups. | Mandatory |
| 5.22.13 | CommissionEarned | Decimal | Total commission earned by the agent for the booking. Represents the agent's revenue from the transaction. | Mandatory |
| 5.22.14 | TdsOnCommission | Decimal | Tax Deducted at Source (TDS) applicable to the earned commission. | Mandatory |
| 5.23 | FareBreakdown[] | Array | Details of fare breakup into several parts. It gives fare of Each Passenger Type | Mandatory |
| 5.23.1 | PassengerType | Integer | Passenger Type 1 - Adult, 2 - Child, 3 - Infant | Mandatory |
| 5.23.2 | PassengerCount | Integer | Total number of passengers belonging to the specified passenger type. | Mandatory |
| 5.23.3 | BaseFare | Decimal | Total base fare applicable to the specified passenger type before taxes and surcharges. | Mandatory |
| 5.23.4 | Tax | Decimal | Total tax amount applicable to the specified passenger type. | Mandatory |
| 5.23.5 | YQTax | Decimal | Fuel surcharge applicable to the specified passenger type. | Mandatory |
| 5.23.6 | AdditionalTxnFeeOfrd | Decimal | Additional transaction fee included in the offered fare. This amount may be collected from the customer but is not charged by SRDV. | Mandatory |
| 5.23.7 | AdditionalTxnFeePub | Decimal | Additional transaction fee included in the published fare. This amount may be collected from the customer but is not charged by SRDV. | Mandatory |
| 5.24 | Segments[] | Array | List of flight segments included in the itinerary. | Mandatory |
| 5.24.1 | IsRefundable | Boolean | Indicates whether the ticket is eligible for a refund. (Value – True or False) | Mandatory |
| 5.24.2 | Baggage | String | Checked baggage allowance for the passenger. | Mandatory |
| 5.24.3 | CabinBaggage | String | Cabin/hand baggage allowance permitted onboard. | Mandatory |
| 5.24.4 | CabinClassName | String | Name of the travel cabin class (Economy, Business, First, etc.). | Mandatory |
| 5.24.5 | CabinClassCode | Integer | Numeric code representing the cabin class. | Mandatory |
| 5.24.6 | TripIndicator | Integer | Identifies the trip sequence within the itinerary. | Mandatory |
| 5.24.7 | SegmentIndicator | Integer | Unique identifier for the flight segment within the trip. | Mandatory |
| 5.24.8 | Airline{} | Object | Details of the airline operating the flight segment. | Mandatory |
| 5.24.8.1 | AirlineCode | String | IATA airline code (e.g., AI, 6E, UK). | Mandatory |
| 5.24.8.2 | AirlineName | String | Full name of the airline. | Mandatory |
| 5.24.8.3 | FlightNumber | String | Flight number assigned by the airline. | Mandatory |
| 5.24.8.4 | FareClass | String | Booking or fare class associated with the ticket. | Mandatory |
| 5.24.8.5 | OperatingCarrier | String | Airline actually operating the flight. | Mandatory |
| 5.24.9 | NoOfSeatAvailable | Integer | Number of seats currently available for booking. | Mandatory |
| 5.24.10 | Origin{} | Object | Departure airport and location details. | Mandatory |
| 5.24.10.1 | AirportCode | String | IATA airport code (e.g., DEL, BOM, JFK). | Mandatory |
| 5.24.10.2 | AirportName | String | Full name of the airport. | Optional |
| 5.24.10.3 | Terminal | String | Terminal from which the flight departs or arrives. | Optional |
| 5.24.10.4 | CityCode | String | Standard code representing the city. | Mandatory |
| 5.24.10.5 | CityName | String | Name of the city. | Mandatory |
| 5.24.10.6 | CountryCode | String | ISO country code of the airport location. | Mandatory |
| 5.24.10.7 | CountryName | String | Name of the country where the airport is located. | Mandatory |
| 5.24.11 | DepTime | Date Time | Scheduled departure date and time. | Mandatory |
| 5.24.12 | Destination{} | Object | Arrival airport and location details. | Mandatory |
| 5.24.12.1 | AirportCode | String | IATA airport code (e.g., DEL, BOM, JFK). | Mandatory |
| 5.24.12.2 | AirportName | String | Full name of the airport. | Mandatory |
| 5.24.12.3 | Terminal | String | Terminal from which the flight departs or arrives. | Optional |
| 5.24.12.4 | CityCode | String | Standard code representing the city. | Mandatory |
| 5.24.12.5 | CityName | String | Name of the city. | Mandatory |
| 5.24.12.6 | CountryCode | String | ISO country code of the airport location. | Mandatory |
| 5.24.12.7 | CountryName | String | Name of the country where the airport is located. | Mandatory |
| 5.24.13 | ArrTime | Date Time | Scheduled arrival date and time. | Mandatory |
| 5.24.14 | Duration | Time | Total flight duration for the segment. | Optional |
| 5.24.15 | GroundTime | Time | Layover duration before the next connecting flight. | Optional |
| 5.24.16 | AccumulatedDuration | Time | Total travel time accumulated up to this segment. | Optional |
| 5.24.17 | Mile | String | Distance covered by the flight segment in miles. | Optional |
| 5.24.18 | StopOver | String | Indicates whether the flight includes a stopover. | Optional |
| 5.24.19 | StopPoint | String | Airport or city where the stopover occurs. | Optional |
| 5.24.20 | StopPointArrivalTime | Date Time | Arrival date and time at the stopover location. | Optional |
| 5.24.21 | StopPointDepartureTime | Date Time | Departure date and time from the stopover location. | Optional |
| 5.24.22 | Craft | String | Aircraft type used for the flight segment. | Optional |
| 5.24.23 | Remark | String | Additional information or notes related to the flight. | Optional |
| 5.24.24 | IsETicketEligible | Boolean | Indicates whether electronic ticketing is supported.(Value – true or false) | Mandatory |
| 5.24.25 | FlightStatus | String | Current operational status of the flight (Scheduled, Delayed, Cancelled, etc.). | Mandatory |
| 5.24.26 | Status | String | Availability or booking status of the flight segment. | Mandatory |
| 5.25 | AirlineCode | String | IATA airline code (e.g., AI, 6E, UK). | Mandatory |
| 5.26 | ValidatingAirline | String | Airline responsible for ticket issuance and validation. | Mandatory |