Flight APIS
Flight Search

Flight Search API

POST

Endpoint:[BaseUrl]/flight-search

Overview

The Flight Search API allows you to search for available flights based on specified criteria including origin, destination, dates, and passenger information.

Request Parameters

ParameterTypeRequiredDescription
adultsIntegerYesNumber of adult passengers (age > 12)
childsIntegerNoNumber of child passengers (age 2-12)
infantsIntegerNoNumber of infant passengers (age < 2)
classStringYesCabin class (Economy, Premium Economy, Business, First)
journeyTypeIntegerYes1=One Way, 2=Round Trip, 3=Multi City
routesArrayYesArray of flight segments containing origin, destination airport codes and departure dates
preferredCarriersArrayNoList of preferred airline carriers
childrenAgesArrayConditionalRequired if childs > 0. Array containing ages of all child passengers
fare_typeIntegerYes1=General, 2=Labor fare
Request
{
  "adults": 1,
  "childs": 0,
  "infants": 0,
  "journeyType": 1,
  "class": "Economy",
  "preferredCarriers": [],
  "childrenAges": [],
  "fare_type": "1",
  "routes": [
    {
      "origin": "KUL",
      "destination": "DAC",
      "departureDate": "2025-01-15"
    }
  ]
}
Response
{
  "flag": true,
  "code": 200,
  "message": "Success",
  "data": {
    "AirSearchResponses": [
      {
        "Directions": [
          [
            {
              "Origin": "KUL",
              "OriginName": "Kuala Lumpur International Airport",
              "Destination": "DAC",
              "DestinationName": "Hazrat Shahjalal International Airport",
              "PlatingCarrierCode": "BG",
              "PlatingCarrierName": "Biman Bangladesh Airlines",
              "Stops": 0,
              "Segments": [
                {
                  "Origin": "KUL",
                  "OriginName": "Kuala Lumpur International Airport",
                  "Destination": "DAC",
                  "DestinationName": "Hazrat Shahjalal International Airport",
                  "Group": 0,
                  "Departure": "2025-01-15 02:30:00",
                  "Arrival": "2025-01-15 04:20:00",
                  "Airline": "Biman Bangladesh Airlines",
                  "FlightNumber": "387",
                  "SegmentCodeRef": "Vi9CYXdNVHFXREtBTFJ3b0FBQUFBQT09fFYvQmF3TVRxV0RLQVpSd29BQUFBQUE9PXxWL0Jhd01UcVdES0E0UHdvQUFBQUFBPT0=",
                  "Details": [
                    {
                      "Origin": "KUL",
                      "OriginName": "Kuala Lumpur International Airport",
                      "Destination": "DAC",
                      "DestinationName": "Hazrat Shahjalal International Airport",
                      "OriginTerminal": "1",
                      "DestinationTerminal": "2",
                      "Departure": "2025-01-15 02:30:00",
                      "Arrival": "2025-01-15 04:20:00",
                      "FlightTime": "3h 50m",
                      "TravelTime": "3h 50m",
                      "Equipment": "Boeing-738"
                    }
                  ],
                  "ServiceClass": "Economy",
                  "Plane": [
                    "738"
                  ],
                  "Duration": [
                    "3h 50m"
                  ],
                  "TechStops": [
                    0
                  ],
                  "BookingClass": "E",
                  "BookingCount": "9",
                  "Baggage": [
                    {
                      "Units": "Kilograms",
                      "Amount": 35,
                      "PassengerTypeCode": "ADT"
                    }
                  ],
                  "FareBasisCode": "EMYO",
                  "AirlineCode": "BG"
                }
              ],
              "DirectionTotalTime": "3h 50m"
            }
          ]
        ],
        "BookingComponent": {
          "DiscountPrice": 0,
          "TotalPrice": 16482,
          "BasePrice": 13831,
          "Taxes": 2602,
          "AIT": 49,
          "FareReference": "",
          "AgentAdditionalPrice": 0
        },
        "OriginalPriceComponent": {
          "TotalPrice": 16433,
          "BasePrice": 13831,
          "Taxes": 2602
        },
        "PassengerFares": [
          {
            "PassengerType": "ADT",
            "PassengerCount": 1,
            "DiscountPrice": 0,
            "AIT": 49,
            "TotalPrice": 16482,
            "BasePrice": 13831,
            "EquivalentBasePrice": 13831,
            "Taxes": 2602,
            "ServiceCharge": 0,
            "TaxesBreakdown": [
              {
                "Category": "G1",
                "Amount": 554
              },
              {
                "Category": "H8",
                "Amount": 28
              },
              {
                "Category": "MY",
                "Amount": 2020
              }
            ]
          }
        ],
        "UniqueTransID": "NZ2347951294210494",
        "ItemCodeRef": "TloyMzQ3OTUxMjk0MjEwNDk0LTYzODY3MzY3OTYxMDgxNDEzMXxWL0Jhd01UcVdES0FJVndvQUFBQUFBPT18R2FsaWxlb3wxRy1CRA==",
        "TotalPrice": 16482,
        "BasePrice": 13831,
        "EqivqlBasePrice": 13831,
        "Taxes": 2602,
        "PlatingCarrierName": "Biman Bangladesh Airlines",
        "PlatingCarrier": "BG",
        "FareType": "Public",
        "FareTypeDec": "UnknownType",
        "Refundable": true,
        "Bookable": true,
        "AvlSrc": "#27150c"
      }
    ],
    "AirlineFilters": [
      {
        "AirlineCode": "BG",
        "AirlineName": "Biman Bangladesh Airlines",
        "TotalFlights": 4,
        "MinPrice": 16482
      },
      {
        "AirlineCode": "MH",
        "AirlineName": "Malaysia Airlines",
        "TotalFlights": 2,
        "MinPrice": 34378
      }
    ],
    "MinMaxPrice": {
      "MinPrice": 16482,
      "MaxPrice": 136562
    },
    "Stops": [
      0,
      1
    ],
    "TotalFlights": 2,
    "Currency": "BDT",
    "FinalResponseTime": "16-Nov-2024 03:32:48 PM"
  }
}

Important Response Fields

FieldDescription
UniqueTransIDRequired for subsequent API calls
ItemCodeRefRequired for fare rules and booking
BookableIndicates if direct booking is possible
RefundableIndicates if the fare is refundable