FR24 OpenAPI
  1. API Reference
FR24 OpenAPI
  • FR24_API_V2.0
    • Guides
      • API Work Flow
      • Introduction
      • Appendix
      • Version History
      • Error Code
    • API Reference
      • shopping
        POST
      • pricing
        POST
      • presaleAncillaryShopping
        POST
      • seatMap
        POST
      • booking
        POST
      • ticketing
        POST
      • orderChangeInforming
        POST
      • orderDetail
        POST
      • postsaleAncillaryShopping
        POST
      • ancillaryBooking
        POST
      • ancillaryPurchase
        POST
      • ancillaryOrderDetail
        POST
      • changeReshop
        POST
      • reissueRequest
        POST
      • refundRequest
        POST
      • refundConfirming
        POST
      • voidRequest
        POST
      • fileUpload
        POST
      • selectBalance
        POST
    • About us
      • API capability
      • Business Cooperation
      • Portal
  1. API Reference

shopping

POST
/api/new/shopping.do
Searching available flight information through the Shopping API, supports one-way, round trip, notch route.

Request

Header Params

Body Params application/json

Example
{
    "authentication": {
        "sign": "{{sign}}",
        "timestamp": "{{timestamp}}"
    },
    "searchLegs": [
        {
            "typeO": "airportgroup",
            "origin": "SIN",
            "typeD": "airportcode",
            "destination": "HKG",
            "depDate": "2025-11-15"
        }
    ],
    "adultNum": 2,
    "childNum": 0,
    "infantNum": 0,
    "preferences": {
        "cabin": "Y",
        "preferredCarrier": [
            "AB"
        ],
        "prohibitedCarrier": [
            "CD"
        ],
        "stops": 0
    }
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://flight-test.flightroutes24.com/api/new/shopping.do' \
--header 'Accept-Encoding;' \
--header 'appKey;' \
--header 'content-Type: application/json' \
--data-raw '{
    "authentication": {
        "sign": "",
        "timestamp": ""
    },
    "searchLegs": [
        {
            "typeO": "airportgroup",
            "origin": "SIN",
            "typeD": "airportcode",
            "destination": "HKG",
            "depDate": "2025-11-15"
        }
    ],
    "adultNum": 2,
    "childNum": 0,
    "infantNum": 0,
    "preferences": {
        "cabin": "Y",
        "preferredCarrier": [
            "AB"
        ],
        "prohibitedCarrier": [
            "CD"
        ],
        "stops": 0
    }
}'

Responses

🟢200OK
application/json
Body

Example
{
    "traceId": "queryFlight_NEWAPI230911165800484095",
    "code": "000000",
    "message": "success",
    "processingTime": 676,
    "data": {
        "offers": [
            {
                "offerId": "15803089789194240",
                "legId": "55623c5bf92ccd6d3cf30b543c0bd5ad",
                "currency": "CNY",
                "platingCarrier": "IJ",
                "pricePerPax": [
                    {
                        "paxType": "ADT",
                        "baseFare": 2356,
                        "totalTax": 2050,
                        "taxBreakdown": [],
                        "serviceFee": null
                    }
                ],
                "cabin": [
                    "Y"
                ],
                "fareBasis": [
                    null
                ],
                "availability": [
                    "9"
                ],
                "extraInfo": {
                    "freeBaggageAllowance": [
                        {
                            "segmentId": "d50b31d910612e8edb45b9466649a3a3",
                            "cabinBagPc": "e-e-e",
                            "cabinBagSize": "e-e-e",
                            "cabinBagWeight": "e-e-e",
                            "checkedBagPc": "e-e-e",
                            "checkedBagSize": "e-e-e",
                            "checkedBagWeight": "20-e-e"
                        }
                    ]
                },
                "eligibilityFlag": false,
                "eligibilityDetail": null,
                "rules": {
                    "refund": [
                        {
                            "paxType": "ADT",
                            "couponStatus": 0,
                            "refundPolicy": "airlinePolicyApplied",
                            "applicableTime": null,
                            "fullRefundAP": null,
                            "refundFee": null
                        }
                    ],
                    "change": [
                        {
                            "paxType": "ADT",
                            "couponStatus": 0,
                            "changePolicy": "airlinePolicyApplied",
                            "applicableTime": null,
                            "changeFee": null
                        }
                    ]
                },
                "productType": "AAA",
                "productTag": {
                    "ticketPromise": 0,
                    "refuseDeadline": 0,
                    "ticketingTime": 60,
                    "reschedulePendingTime": 240,
                    "voluntaryRefundTime": 21600,
                    "involuntaryRefundTime": 21600,
                    "refundCondition": 0,
                    "reissueCondition": 0,
                    "voidingCondition": false,
                    "voluntaryServiceStandard": 2,
                    "involuntaryServiceStandard": 1,
                    "RBDChangedRisk": false,
                    "fareBrand": [
                        "basic economy^full flex",
                        "basic economy",
                        ""
                    ],
                    "posArea": [
                        "US",
                        "CN"
                    ]
                },
                "productSource": "OTH",
                "RBD": [
                    "K"
                ]
            },
            {
                "offerId": "15803089789194241",
                "legId": "6569cc7f11c26f09901f5af0063aff8c",
                "currency": "CNY",
                "platingCarrier": "IJ",
                "pricePerPax": [
                    {
                        "paxType": "ADT",
                        "baseFare": 2573,
                        "totalTax": 2239,
                        "taxBreakdown": [],
                        "serviceFee": null
                    }
                ],
                "cabin": [
                    "Y"
                ],
                "fareBasis": [
                    null
                ],
                "availability": [
                    "9"
                ],
                "extraInfo": {
                    "freeBaggageAllowance": [
                        {
                            "segmentId": "3dfc73915f991967df377cc232a4eeef",
                            "cabinBagPc": "e-e-e",
                            "cabinBagSize": "e-e-e",
                            "cabinBagWeight": "e-e-e",
                            "checkedBagPc": "e-e-e",
                            "checkedBagSize": "e-e-e",
                            "checkedBagWeight": "20-e-e"
                        }
                    ]
                },
                "eligibilityFlag": false,
                "eligibilityDetail": null,
                "rules": {
                    "refund": [
                        {
                            "paxType": "ADT",
                            "couponStatus": 0,
                            "refundPolicy": "airlinePolicyApplied",
                            "applicableTime": null,
                            "fullRefundAP": null,
                            "refundFee": null
                        }
                    ],
                    "change": [
                        {
                            "paxType": "ADT",
                            "couponStatus": 0,
                            "changePolicy": "airlinePolicyApplied",
                            "applicableTime": null,
                            "changeFee": null
                        }
                    ]
                },
                "productType": "AAA",
                "productTag": {
                    "ticketPromise": 0,
                    "refuseDeadline": 0,
                    "ticketingTime": 60,
                    "reschedulePendingTime": 240,
                    "voluntaryRefundTime": 21600,
                    "involuntaryRefundTime": 21600,
                    "refundCondition": 0,
                    "reissueCondition": 0,
                    "voidingCondition": false,
                    "voluntaryServiceStandard": 2,
                    "involuntaryServiceStandard": 1,
                    "RBDChangedRisk": false,
                    "fareBrand": [
                        "basic economy^full flex",
                        "basic economy",
                        ""
                    ],
                    "posArea": [
                        "US",
                        "CN"
                    ]
                },
                "productSource": "OTH",
                "RBD": [
                    "S"
                ]
            },
            {
                "offerId": "15803089789194242",
                "legId": "e3504f0918ff9594ec8537663b02f925",
                "currency": "CNY",
                "platingCarrier": "IJ",
                "pricePerPax": [
                    {
                        "paxType": "ADT",
                        "baseFare": 3327,
                        "totalTax": 2896,
                        "taxBreakdown": [],
                        "serviceFee": null
                    }
                ],
                "cabin": [
                    "Y"
                ],
                "fareBasis": [
                    null
                ],
                "availability": [
                    "9"
                ],
                "extraInfo": {
                    "freeBaggageAllowance": [
                        {
                            "segmentId": "b628821e9ac613fb74d9fc49d8391883",
                            "cabinBagPc": "e-e-e",
                            "cabinBagSize": "e-e-e",
                            "cabinBagWeight": "e-e-e",
                            "checkedBagPc": "e-e-e",
                            "checkedBagSize": "e-e-e",
                            "checkedBagWeight": "20-e-e"
                        }
                    ]
                },
                "eligibilityFlag": false,
                "eligibilityDetail": null,
                "rules": {
                    "refund": [
                        {
                            "paxType": "ADT",
                            "couponStatus": 0,
                            "refundPolicy": "airlinePolicyApplied",
                            "applicableTime": null,
                            "fullRefundAP": null,
                            "refundFee": null
                        }
                    ],
                    "change": [
                        {
                            "paxType": "ADT",
                            "couponStatus": 0,
                            "changePolicy": "airlinePolicyApplied",
                            "applicableTime": null,
                            "changeFee": null
                        }
                    ]
                },
                "productType": "AAA",
                "productTag": {
                    "ticketPromise": 0,
                    "refuseDeadline": 0,
                    "ticketingTime": 60,
                    "reschedulePendingTime": 240,
                    "voluntaryRefundTime": 21600,
                    "involuntaryRefundTime": 21600,
                    "refundCondition": 0,
                    "reissueCondition": 0,
                    "voidingCondition": false,
                    "voluntaryServiceStandard": 2,
                    "involuntaryServiceStandard": 1,
                    "RBDChangedRisk": false,
                    "fareBrand": [
                        "basic economy^full flex",
                        "basic economy",
                        ""
                    ],
                    "posArea": [
                        "US",
                        "CN"
                    ]
                },
                "productSource": "OTH",
                "RBD": [
                    "U"
                ]
            }
        ],
        "legs": [
            {
                "legId": "55623c5bf92ccd6d3cf30b543c0bd5ad",
                "segmentIds": [
                    "d50b31d910612e8edb45b9466649a3a3"
                ]
            },
            {
                "legId": "6569cc7f11c26f09901f5af0063aff8c",
                "segmentIds": [
                    "3dfc73915f991967df377cc232a4eeef"
                ]
            },
            {
                "legId": "e3504f0918ff9594ec8537663b02f925",
                "segmentIds": [
                    "b628821e9ac613fb74d9fc49d8391883"
                ]
            }
        ],
        "segments": [
            {
                "segmentId": "d50b31d910612e8edb45b9466649a3a3",
                "duration": 142,
                "carrier": "IJ",
                "flightNo": "5817",
                "codeShare": false,
                "operatingCarrier": null,
                "operatingFlightNo": null,
                "aircraftCode": "333",
                "depAirport": "SIN",
                "depTerminal": null,
                "depTime": "2025-11-15T00:25",
                "arrAirport": "HKG",
                "arrTerminal": null,
                "arrTime": "2025-11-15T02:47",
                "stopAirport": null,
                "stopDuration": null
            },
            {
                "segmentId": "3dfc73915f991967df377cc232a4eeef",
                "duration": 197,
                "carrier": "IJ",
                "flightNo": "1811",
                "codeShare": false,
                "operatingCarrier": null,
                "operatingFlightNo": null,
                "aircraftCode": "333",
                "depAirport": "SIN",
                "depTerminal": null,
                "depTime": "2025-11-15T12:05",
                "arrAirport": "HKG",
                "arrTerminal": null,
                "arrTime": "2025-11-15T15:22",
                "stopAirport": null,
                "stopDuration": null
            },
            {
                "segmentId": "b628821e9ac613fb74d9fc49d8391883",
                "duration": 147,
                "carrier": "IJ",
                "flightNo": "8199",
                "codeShare": false,
                "operatingCarrier": null,
                "operatingFlightNo": null,
                "aircraftCode": "333",
                "depAirport": "QPG",
                "depTerminal": null,
                "depTime": "2025-11-15T12:40",
                "arrAirport": "HKG",
                "arrTerminal": null,
                "arrTime": "2025-11-15T15:07",
                "stopAirport": null,
                "stopDuration": null
            }
        ]
    }
}
Modified at 2025-06-12 09:39:26
Previous
Error Code
Next
pricing
Built with