Fare Quote API

The Fare Quote API allows you to retrieve detailed fare information for specific flight options after performing a flight search. This API provides comprehensive details about pricing, segments, fare rules, and booking conditions for selected flights.

Overview

After conducting a flight search using the Flight Search API, you can use the tokens returned in the search results to get detailed fare quotes. Each fare quote includes complete flight information, pricing breakdown, fare rules, and booking conditions.

Endpoint

POST /flight/fare_quote

Authentication

All requests require proper authentication headers:

client-id: Your unique client identifier
client-secret: Your client secret key
Content-Type: application/json

Request Structure

Parameters

Parameter	Type	Required	Description
`trace_id`	string	Yes	Unique trace identifier from the flight search response
`token`	string	Yes	Flight token obtained from the search results
`client_referenceId`	string	Yes	Unique client reference ID for tracking

Example Request

{
    "trace_id": "c8812945-36ab-481c-84e6-413aa438f511",
    "token": "OB1[TBO]BwVNdj4P3j1AoCZQ+gmNK+0thztrQjDuTcA1EcRvENizNi6mw8IvRZBZOqDgt/YWFDvPACpKpP+bpgDFD008yjJrNQeEpOnZrtlczEYT9nR83cHVMntQTtty+JmqCXEaRg5D1RMSeB/GBH+5dY9GTw2fU0pLFWNP3IYGrPc+l9yZnkPgDYeUGDRf/y+TfUG0EfJJ8okrz1riCLL0l6vPHqU1MV2TAM8mkMP5aol/99kxsW+9mtoRKhrCBauxjUTsf3fk8PG19+iPBpOf4BnwxzXUZNxqcFqmIyUO1t6B/idkmsgcsissXNTv/NK6JLs4U+u42/+uyj4fjg777M/xpNFtPEAAez6KEn7WBVDbNwjBT++tt+4KtmztAxfkg3UytbOafNlM6kWe+16Yv/X/1w6eiyRP49Iwj2KbuuL0dO9BaT9Ja953lFPimTFQ9pFThDP4b75AycDv+k24vDBKYc5XXx2uJfLPzQLMhFjARZT8izmSP995al2P59ZUdGIcWvhmUj6qGQ5ArfbC2QLtE4T9hyNvITSXdH9AfkDilNFXxtsMLDRctoN3xcL7waRxq8hwUQ9JxHmvkXykZKAmRFX7j5ciUg29+NOjLvU9mYisc5/1VH/G3FiYNhrVCpkZe/Yrj8EYYEXBghSixtFMxCKZDjjoGBd+KlquKsA4yWY=",
    "client_referenceId": "swg776774338278w"
}

Response Structure

Success Response (200)

The API returns detailed fare information including flight segments, pricing, fare rules, and booking conditions.

Field	Type	Description
`status`	string	Response status (SUCCESS/FAILED)
`status_code`	string	HTTP status code
`message`	string	Response message
`data.trace_id`	string	Original trace ID from the request
`data.result`	array	Array of fare quote results

Fare Quote Result Structure

Each result contains comprehensive flight and fare information:

Basic Information

token: Flight booking token
source: Airline source (e.g., "Indigo")
airline_code: IATA airline code (e.g., "6E")
validating_airline: Airline responsible for validation
fare_type: Type of fare (e.g., "SeniorFare")

Booking Conditions

refundable: Whether the ticket is refundable
coupon_applicable: If discount coupons can be applied
pan_required_at_book: PAN card requirement for booking
passport_required_at_book: Passport requirement for booking
gst_mandatory: GST requirement

Flight Segments

Each segment includes:

Flight details (flight number, airline, fare class)
Origin and destination information (airport codes, names, terminals, times)
Duration and baggage allowances
Flight status and class information

Fare Information

currency: Fare currency
basefare: Base fare amount
tax_and_surcharges: Additional taxes and surcharges
total_fare: Complete fare including all charges

Example Response

{
    "status": "SUCCESS",
    "status_code": "200",
    "message": "Fare quote retrieved successfully.",
    "data": {
        "trace_id": "c8812945-36ab-481c-84e6-413aa438f511",
        "result": [
            {
                "token": "OB1[TBO]BwVNdj4P3j1AoCZQ+gmNK+0thztrQjDuTcA1EcRvENizNi6mw8IvRZBZOqDgt/YWFDvPACpKpP+bpgDFD008yjJrNQeEpOnZrtlczEYT9nR83cHVMntQTtty+JmqCXEaRg5D1RMSeB/GBH+5dY9GTw2fU0pLFWNP3IYGrPc+l9yZnkPgDYeUGDRf/y+TfUG0EfJJ8okrz1riCLL0l6vPHqU1MV2TAM8mkMP5aol/99kxsW+9mtoRKhrCBauxjUTsf3fk8PG19+iPBpOf4BnwxzXUZNxqcFqmIyUO1t6B/idkmsgcsissXNTv/NK6JLs4U+u42/+uyj4fjg777M/xpNFtPEAAez6KEn7WBVDbNwjBT++tt+4KtmztAxfkg3UytbOafNlM6kWe+16Yv/X/1w6eiyRP49Iwj2KbuuL0dO9BaT9Ja953lFPimTFQ9pFThDP4b75AycDv+k24vDBKYc5XXx2uJfLPzQLMhFjARZT8izmSP995al2P59ZUdGIcWvhmUj6qGQ5ArfbC2QLtE4T9hyNvITSXdH9AfkDilNFXxtsMLDRctoN3xcL7waRxq8hwUQ9JxHmvkXykZKAmRFX7j5ciUg29+NOjLvU9mYisc5/1VH/G3FiYNhrVCpkZe/Yrj8EYYEXBghSixtFMxCKZDjjoGBd+KlquKsA4yWY=",
                "fname_format": "If FirstName is missing, Update FirstName as LastName.\r\n\t\t\t<br/> For UAE Sector- If there is a space in the passenger's last name, then split it (ie, put the name before the space in the first name).\r\n\t\t\t<br/> If the passenger has a single word name in last name so put father name will be the first name as per passport.",
                "lname_format": "If LastName is missing, Update LastName and FirstName as FirstName.\r\n\t\t\t<br/> For UAE Sector - If there is a space in the passenger's given name, then split it (ie, put the name after the space in the last name).\r\n\t\t\t<br/> If the passenger has a single word name in given name so put father name will be the last name as per passport.",
                "source": "Indigo",
                "airline_code": "6E",
                "airline_remark": "6E main, Senior fare result.",
                "validating_airline": "6E",
                "is_lcc": true,
                "free_meal": false,
                "refundable": true,
                "coupon_applicable": true,
                "pan_required_at_book": false,
                "pan_required_at_ticket": false,
                "passport_required_at_book": false,
                "passport_required_at_ticket": false,
                "hold_mandatory_with_ssr": false,
                "gst_mandatory": false,
                "last_ticket_date": "0001-01-01 00:00:00",
                "segments": [
                    {
                        "trip_indicator": "outbound",
                        "segment_indicator": "outbound",
                        "flight_number": "449",
                        "airline_code": "6E",
                        "airline_name": "IndiGo",
                        "fare_class": "QR",
                        "operating_carrier": "",
                        "origin": {
                            "airport_code": "DEL",
                            "airport_name": "Indira Gandhi Airport",
                            "terminal": "1D",
                            "city_code": "DEL",
                            "city_name": "Delhi",
                            "country_code": "IN",
                            "country_name": "India",
                            "departure_time": "2025-06-01 05:00:00"
                        },
                        "destination": {
                            "airport_code": "BOM",
                            "airport_name": "Chhatrapati Shivaji International Airport",
                            "terminal": "2",
                            "city_code": "BOM",
                            "city_name": "Mumbai",
                            "country_code": "IN",
                            "country_name": "India",
                            "arrival_time": "2025-06-01 07:10:00"
                        },
                        "duration": "2h 10m",
                        "baggage": {
                            "checked_baggage": "15 Kilograms",
                            "cabin_baggage": "7 KG"
                        },
                        "flight_class": "Saver (Regular)",
                        "is_stopover": false,
                        "e-ticket_available": true,
                        "flight_status": "Confirmed"
                    }
                ],
                "fare_type": "SeniorFare",
                "fare": {
                    "currency": "INR",
                    "basefare": 4662,
                    "tax_and_surcharges": 915,
                    "total_fare": 5577
                },
                "fare_breakdown": [
                    {
                        "currency": "INR",
                        "passenger_type": "adult",
                        "passenger_count": 1,
                        "basefare": 4662
                    }
                ],
                "fare_inclusions": [],
                "fare_rules": [
                    {
                        "origin": "DEL",
                        "destination": "BOM",
                        "airline": "6E",
                        "fare_rules": ""
                    }
                ],
                "mini_fare_rules": [
                    {
                        "journey_points": "DEL-BOM",
                        "type": "Reissue",
                        "from": "0",
                        "to": "3",
                        "unit": "DAYS",
                        "charges": "INR 2999",
                        "online_reissue_allowed": false,
                        "online_refund_allowed": false
                    },
                    {
                        "journey_points": "DEL-BOM",
                        "type": "Reissue",
                        "from": "4",
                        "to": "",
                        "unit": "DAYS",
                        "charges": "INR 2250",
                        "online_reissue_allowed": false,
                        "online_refund_allowed": false
                    },
                    {
                        "journey_points": "DEL-BOM",
                        "type": "Cancellation",
                        "from": "0",
                        "to": "3",
                        "unit": "DAYS",
                        "charges": "INR 3999",
                        "online_reissue_allowed": false,
                        "online_refund_allowed": false
                    },
                    {
                        "journey_points": "DEL-BOM",
                        "type": "Cancellation",
                        "from": "4",
                        "to": "",
                        "unit": "DAYS",
                        "charges": "INR 2999",
                        "online_reissue_allowed": false,
                        "online_refund_allowed": false
                    },
                    {
                        "journey_points": "DEL-BOM",
                        "type": "Reissue",
                        "from": "44",
                        "to": "444",
                        "unit": "HOURS",
                        "charges": "Unchangeable",
                        "online_reissue_allowed": false,
                        "online_refund_allowed": false
                    }
                ]
            }
        ]
    }
}

Key Features

Comprehensive Fare Information

Detailed Pricing: Base fare, taxes, and total costs with currency information
Fare Breakdown: Per-passenger pricing for different passenger types
Fare Type Identification: Special fare categories like SeniorFare, student discounts, etc.

Flight Details

Complete Segment Information: Flight numbers, airlines, departure/arrival times
Airport Information: Full airport details including terminals and city information
Baggage Allowances: Both checked and cabin baggage limits
Service Information: Meal availability, LCC status, and service class

Booking Conditions

Documentation Requirements: PAN, passport, and GST requirements clearly specified
Refund Policy: Refundability and coupon applicability
Name Format Guidelines: Specific formatting requirements for passenger names

Fare Rules & Policies

Cancellation Policies: Time-based cancellation charges
Change/Reissue Rules: Modification fees and restrictions
Online Service Availability: Whether changes/refunds can be done online

Error Handling

Common error scenarios:

Invalid Token: Token expired or malformed
Flight Unavailable: Selected flight no longer available
System Error: Temporary service unavailability

Always implement proper error handling and retry logic for production applications.