Calendar Fare
This method provides Fare Calendar.
Service URL (REST) to be used:
Calendar Fare 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 | JourneyType | Integer | Specifies the type of journey being searched. ( 1 - OneWay, 2 - Return, 3 - Multi City ) | Mandatory |
| 6 | Sources | String | Airline Sources : SG - Spice Jet, 6E - Indigo, G9 - Air Arabia, FZ - Fly Dubai, IX - Air India, AK - Air Asia, LB - Air Costa | Optional |
| 7 | FareType | Integer | Specifies the passenger fare category for which flight results should be returned. Regular Fare = 1, Student Fare = 2, Senior Citizen = 3, Armed Force = 4 | Mandatory |
| 8 | Segments[] | Array | Collection of journey segments containing route, cabin class, and travel date preferences. | Mandatory |
| 8.1 | Origin | String | IATA airport or city code representing the departure location (e.g., DEL, BOM). | Mandatory |
| 8.2 | Destination | String | IATA airport or city code representing the arrival location (e.g., DEL, BOM). | Mandatory |
| 8.3 | FlightCabinClass | Integer | Specifies the preferred cabin class for the flight search. (1 for All, 2 for Economy, 3 for PremiumEconomy, 4 for Business, 5 for PremiumBusiness, 6 for First Class) | Mandatory |
| 8.4 | PreferredDepartureTime | Date Time | Preferred departure date and time for the journey segment. Used to filter flight results based on departure schedules. Date time Format: yyyy-MM-ddTHH:mm:ss 2015-08-10T00:00:00 - Any time , 2015-08-10T08:00:00 - Morning Flights , 2015-08-10T14:00:00 - Afternoon Flights 2015-08-10T19:00:00 - Evening Flights , 2015-08-10T01:00:00 - Night Flights |
Mandatory |
| 8.5 | PreferredArrivalTime | Date Time | Preferred arrival date and time for the journey segment. Used to filter flight results based on arrival schedules.Date time Format: yyyy-MM-ddTHH:mm:ss 2015-08-10T00:00:00 - Any time , 2015-08-10T08:00:00 - Morning Flights , 2015-08-10T14:00:00 - Afternoon Flights 2015-08-10T19:00:00 - Evening Flights , 2015-08-10T01:00:00 - Night Flights |
Mandatory |
Calendar Fare 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 | String | 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 | Origin | String | IATA airport or city code representing the departure location. | Mandatory |
| 5 | Destination | String | IATA airport or city code representing the arrival location. | Mandatory |
| 6 | Results[] | Array | Collection of fare results available for the specified route.( May be empty if no fares are available for the requested search criteria.) | Mandatory |
| 6.1 | AirlineCode | String | IATA airline code identifying the carrier (e.g., AI, 6E, UK). | Mandatory |
| 6.2 | AirlineName | String | Full name of the airline offering the fare. | Mandatory |
| 6.3 | DepartureDate | String | Scheduled departure date and time for the flight.Example: (2024-08-01T08:40:00) | Mandatory |
| 6.4 | IsLowestFareOfMonth | Boolean | Indicates whether the fare is the lowest available fare for the specified month. | Mandatory |
| 6.5 | Fare | Float | Total fare amount payable by the customer, including base fare, taxes, and applicable surcharges. | Mandatory |
| 6.6 | BaseFare | Float | Base ticket fare before taxes, surcharges, and additional fees. | Mandatory |
| 6.7 | Tax | Float | Total tax amount applicable to the fare. | Mandatory |
| 6.8 | OtherCharges | Float | Additional charges imposed by the airline, airport authorities, or regulatory bodies. | Mandatory |
| 6.9 | FuelSurcharge | Float | Fuel surcharge applied by the airline and included in the total fare calculation. | Mandatory |