Flight APIS
Price Check

Price Check API

POST

Endpoint:[BaseUrl]/flight-pricecheck

Overview

The PriceCheck API verifies current pricing and availability before proceeding with booking. This step is crucial to ensure the fare hasn't changed since the initial search.

  • If the "IsPriceChanged" flag is set to true, the updated fare must be displayed using the response from the Price Check API.
  • If the "IsBaggageChanged" flag is true, a pop-up must be generated to show the updated baggage policy retrieved from the Price Check API.
  • In document requirement field "is_required" is true for a passport, then both the passport number and expiry date must be provided as mandatory fields during the booking process.

Request Parameters

ParameterTypeRequiredDescription
ItemCodeRefStringYesReference code from search results
SegmentCodeRefsArrayYesArray of segment codes
UniqueTransIDStringYesTransaction ID from search
Request
{
  "ItemCodeRef": "TloyMzQ3OTIxMzc0NjEyMjMzLTYzODY2NzczNTA4NjAzMjEyMnx...",
  "SegmentCodeRefs": ["WXJyNjNMVnFXREtBTnhvU1BBQUFBQT09..."],
  "UniqueTransID": "NZ2347921374612233"
}
Response
{
  "flag": true,
  "code": 200,
  "message": "success",
  "data": {
    "IsPriceChanged": false,
    "IsBaggageChanged": false,
    "PriceCodeRef": "tdnv1xTYaHbjcJBtqy+A1PDZxkLz53eRKGOnR0DO0+45evs/VALFztQ1mq8KSYpxyiIXIIlDtM0WDsfOGP/p5b6CQM1BDSn5KBlax1/Hrxw=",
    "Currency": "BDT",
    "Warnings": [
      "Taxes returned at the FareInfo level are for informational purposes only, and may differ from those returned at the Itinerary/Passenger Type levels."
    ],
    "Directions": [
      [
        {
          "Origin": "DAC",
          "OriginName": "Hazrat Shahjalal International Airport",
          "Destination": "KUL",
          "DestinationName": "Kuala Lumpur International Airport",
          "PlatingCarrierCode": "BS",
          "PlatingCarrierName": "US-Bangla Airlines",
          "Stops": 0,
          "Segments": [
            {
              "Origin": "DAC",
              "OriginName": "Hazrat Shahjalal International Airport",
              "Destination": "KUL",
              "DestinationName": "Kuala Lumpur International Airport",
              "Group": 0,
              "Departure": "2025-09-01 08:50:00",
              "Arrival": "2025-09-01 14:50:00",
              "Airline": "US-Bangla Airlines",
              "FlightNumber": "315",
              "SegmentCodeRef": null,
              "Details": [
                {
                  "Origin": "DAC",
                  "OriginName": "Hazrat Shahjalal International Airport",
                  "Destination": "KUL",
                  "DestinationName": "Kuala Lumpur International Airport",
                  "OriginTerminal": null,
                  "DestinationTerminal": null,
                  "Departure": "2025-09-01 08:50:00",
                  "Arrival": "2025-09-01 14:50:00",
                  "FlightTime": "4h 0m",
                  "TravelTime": "4h 0m",
                  "Equipment": ""
                }
              ],
              "ServiceClass": "Economy",
              "Plane": ["738"],
              "Duration": ["4h 0m"],
              "TechStops": [0],
              "BookingClass": "Economy,K",
              "BookingCount": null,
              "Baggage": [
                {
                  "Units": "Kilograms",
                  "Amount": 30,
                  "PassengerTypeCode": "ADT"
                },
                {
                  "Units": "Kilograms",
                  "Amount": 10,
                  "PassengerTypeCode": "INF"
                }
              ],
              "CarryBaggage": [
                {
                  "Units": "KG",
                  "Amount": 7,
                  "PassengerTypeCode": "ADT"
                },
                {
                  "Units": "KG",
                  "Amount": 7,
                  "PassengerTypeCode": "INF"
                }
              ],
              "FareBasisCode": "KBDMYO",
              "AirlineCode": "BS"
            }
          ],
          "DirectionTotalTime": "4h 0m"
        }
      ]
    ],
    "BookingComponent": {
      "DiscountPrice": -4324,
      "TotalPrice": 216617,
      "BasePrice": 144141,
      "Taxes": 76158,
      "AIT": 642,
      "FareReference": "6rv08DpCPsp+8fcqRLo48JELVWSGGrk2zriAnbw3fVz2x6ClEuX5ECX79y+z/rKH/bD3W17W+14UxCr4aLGSJIZXQY/pdqbtzCDKUJqZ5Aq65n9Gv48Vo1VnaocsL06v4f82FfaeVZ5zvuM665UARkvpofUCApTHXUbi5azncR7Pa6XCKij+XyZhyeHpctYPrZPwt7zyf2fmLO1pychFDLGNtYs9q9pPuaFnO1WkY+Keptq6r0J4WQGaEtJCkXFM",
      "AgentAdditionalPrice": 0
    },
    "OriginalPriceComponent": [],
    "PassengerFares": [
      {
        "PassengerType": "ADT",
        "PassengerCount": 1,
        "DiscountPrice": -3449,
        "AIT": 508,
        "TotalPrice": 171323,
        "BasePrice": 114960,
        "EquivalentBasePrice": 120036,
        "Taxes": 59304,
        "ServiceCharge": 0,
        "TaxesBreakdown": [
          {
            "Category": "BD",
            "Amount": 3000
          },
          {
            "Category": "OW",
            "Amount": 15000
          },
          {
            "Category": "P7",
            "Amount": 7326
          },
          {
            "Category": "P8",
            "Amount": 7326
          },
          {
            "Category": "UT",
            "Amount": 24000
          },
          {
            "Category": "E5",
            "Amount": 2652
          }
        ]
      },
      {
        "PassengerType": "INF",
        "PassengerCount": 1,
        "DiscountPrice": -875,
        "AIT": 134,
        "TotalPrice": 45294,
        "BasePrice": 29181,
        "EquivalentBasePrice": 30522,
        "Taxes": 16854,
        "ServiceCharge": 0,
        "TaxesBreakdown": [
          {
            "Category": "P7",
            "Amount": 7326
          },
          {
            "Category": "P8",
            "Amount": 7326
          },
          {
            "Category": "E5",
            "Amount": 2202
          }
        ]
      }
    ],
    "UniqueTransID": "NZ159054253870081167",
    "ItemCodeRef": "tdnv1xTYaHbjcJBtqy+A1DMVGzvuDKWZPh7KPjfe0J3CqFVDrFZqYwSXsOHhNqh6m3bVbYon2w8TrskOoG8dEsQpAHhMM6nx4j93nA3IfBk=",
    "TotalPrice": 216617,
    "BasePrice": 144141,
    "EqivqlBasePrice": 144141,
    "Taxes": 76158,
    "PlatingCarrierName": "US-Bangla Airlines",
    "PlatingCarrier": "BS",
    "FareType": "REGULAR FARE",
    "FareTypeDec": "UnknownType",
    "Refundable": true,
    "Bookable": true,
    "AvlSrc": null,
    "DocumentRequirement": [
      {
        "is_required": true,
        "document_type": "passport"
      }
    ]
  }
}

Important: If IsPriceChanged is true, you must use the new PriceCodeRef for booking.