post
https://api.aeronpay.in/api/serviceapi-prod/api/flight/day_calendar_fare
Calendar Fare Of The Day API
The Calendar Fare of the Day API allows you to retrieve flight fare information for a specific date and route, helping you get the best available fares from selected airlines.
API Endpoint
POST /flight/day_calendar_fare
Request Format
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
client_referenceId | string | Yes | Unique reference ID for tracking the request |
origin | string | Yes | IATA airport code for departure city (e.g., "DEL") |
destination | string | Yes | IATA airport code for arrival city (e.g., "BOM") |
cabin_class | string | Yes | Travel class preference ("economy", "business", "first") |
departure_date | string | Yes | Departure date in YYYY-MM-DD format |
departure_period | string | No | Time preference ("morning", "afternoon", "evening", "night") |
source | array | No | Array of airline codes to filter results (e.g., ["6E", "AI"]) |
Example Request
{
"client_referenceId": "REF123456789",
"origin": "DEL",
"destination": "BOM",
"cabin_class": "economy",
"departure_date": "2025-06-01",
"departure_period": "morning",
"source": ["6E"]
}Response Format
Success Response
| Field | Type | Description |
|---|---|---|
status | string | Response status ("SUCCESS" or "ERROR") |
status_code | string | HTTP status code |
message | string | Descriptive message about the response |
data | object | Contains the fare data and metadata |
Data Object
| Field | Type | Description |
|---|---|---|
trace_id | string | Unique identifier for tracking the transaction |
origin | string | Departure airport code |
destination | string | Arrival airport code |
result | array | Array of flight fare options |
Result Array Items
| Field | Type | Description |
|---|---|---|
airline_code | string | IATA airline code (e.g., "6E") |
airline_name | string | Full airline name (e.g., "Indigo") |
departure_time | string | Flight departure date and time (YYYY-MM-DD HH:MM:SS) |
fare | number | Total fare amount in local currency |
basefare | number | Base fare amount before taxes and surcharges |
tax_and_surcharges | number | Additional taxes and surcharge amounts |
Example Response
{
"status": "SUCCESS",
"status_code": "200",
"message": "Calendar fare for the day has been successfully fetched.",
"data": {
"trace_id": "b3ad7061-f6b2-4859-94f1-ddf870dd8414",
"origin": "DEL",
"destination": "BOM",
"result": [
{
"airline_code": "6E",
"airline_name": "Indigo",
"departure_time": "2025-06-01 05:00:00",
"fare": 6021,
"basefare": 6021,
"tax_and_surcharges": 841
}
]
}
}Use Cases
- Fare Comparison: Compare fares across different airlines for the same route
- Price Monitoring: Track fare changes for specific dates and routes
- Travel Planning: Find the most cost-effective flight options for your itinerary
- Budget Analysis: Break down fare components (base fare vs. taxes/surcharges)
Notes
- All fare amounts are returned in the local currency of the departure country
- The
departure_periodparameter helps filter flights based on preferred travel times - Multiple airline codes can be specified in the
sourcearray to compare fares - The
trace_idcan be used for troubleshooting and support inquiries