FlightRoutes24 API(Purchaser)
  1. FR24_API_V1.1.0
FlightRoutes24 API(Purchaser)
  • FR24_API_V1.1.0
    • API Work Flow
    • Introduction
    • Appendix
    • 错误码
    • Error Code
    • Shopping
      POST
    • Pricing
      POST
    • PresaleAncillaryShopping
      POST
    • Booking
      POST
    • Ticketing
      POST
    • OrderDetail
      POST
    • PostsaleAncillaryShopping
      POST
    • AncillaryBooking
      POST
    • AncillaryPurchase
      POST
    • AncillaryOrderDetail
      POST
    • ChangeReshop
      POST
    • ReissueRequest
      POST
    • RefundRequest
      POST
    • RefundConfirming
      POST
    • VoidRequest
      POST
  1. FR24_API_V1.1.0

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": [
        {
            "origin": "BKK",
            "typeO": null,
            "destination": "SIN",
            "typeD": null,
            "depDate": "2024-10-24"
        },
        {
            "origin": "SIN",
            "typeO": null,
            "destination": "BKK",
            "typeD": null,
            "depDate": "2024-11-17"
        }
    ],
    "adultNum": 1,
    "childNum": 0,
    "infantNum": 0,
    "preferences": {
        "cabin": "Y",
        "preferredCarrier": null,
        "prohibitedCarrier": null,
        "stops": null,
        "resultCtrl": null
    }
}

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": [
        {
            "origin": "BKK",
            "typeO": null,
            "destination": "SIN",
            "typeD": null,
            "depDate": "2024-10-24"
        },
        {
            "origin": "SIN",
            "typeO": null,
            "destination": "BKK",
            "typeD": null,
            "depDate": "2024-11-17"
        }
    ],
    "adultNum": 1,
    "childNum": 0,
    "infantNum": 0,
    "preferences": {
        "cabin": "Y",
        "preferredCarrier": null,
        "prohibitedCarrier": null,
        "stops": null,
        "resultCtrl": null
    }
}'

Responses

🟢200OK
application/json
Body

Example
{
    "traceId": "queryFlight_NEWAPI24093010481195307702",
    "code": "000000",
    "message": "ok",
    "processingTime": 1064,
    "data": {
        "offers": [
            {
                "offerId": "17981625171120128",
                "legId": "4ad38e31d03829dae6035cf4eb6fc972",
                "currency": "USD",
                "platingCarrier": "FD",
                "pricePerPax": [
                    {
                        "paxType": "ADT",
                        "baseFare": 315.2,
                        "totalTax": 40.02,
                        "taxBreakdown": [],
                        "serviceFee": null
                    }
                ],
                "cabin": [
                    "Y",
                    "Y"
                ],
                "fareBasis": [
                    "DSVFED",
                    "DSVFED"
                ],
                "availability": [
                    "9",
                    "5"
                ],
                "extraInfo": {
                    "freeBaggageAllowance": [
                        {
                            "segmentId": "cdabc75289fb9dcf917526324de0e878",
                            "cabinBagPc": "0-0-0",
                            "cabinBagSize": "e-e-e",
                            "cabinBagWeight": "0-0-0",
                            "checkedBagPc": "0-0-0",
                            "checkedBagSize": "e-e-e",
                            "checkedBagWeight": "0-0-0"
                        },
                        {
                            "segmentId": "82ba60be4c9f9af3c2cdb06dd78403ae",
                            "cabinBagPc": "0-0-0",
                            "cabinBagSize": "e-e-e",
                            "cabinBagWeight": "0-0-0",
                            "checkedBagPc": "0-0-0",
                            "checkedBagSize": "e-e-e",
                            "checkedBagWeight": "0-0-0"
                        }
                    ]
                },
                "eligibilityFlag": true,
                "eligibilityDetail": null,
                "rules": {
                    "refund": [
                        {
                            "paxType": "ADT",
                            "couponStatus": 1,
                            "refundPolicy": "withCondition",
                            "applicableTime": [
                                null,
                                null
                            ],
                            "fullRefundAP": null,
                            "refundFee": 99
                        },
                        {
                            "paxType": "CHD",
                            "couponStatus": 1,
                            "refundPolicy": "withCondition",
                            "applicableTime": [
                                null,
                                null
                            ],
                            "fullRefundAP": null,
                            "refundFee": 99
                        }
                    ],
                    "change": [
                        {
                            "paxType": "ADT",
                            "couponStatus": 1,
                            "changePolicy": "withCondition",
                            "applicableTime": [
                                null,
                                null
                            ],
                            "changeFee": 99
                        },
                        {
                            "paxType": "CHD",
                            "couponStatus": 1,
                            "changePolicy": "withCondition",
                            "applicableTime": [
                                null,
                                null
                            ],
                            "changeFee": 99
                        }
                    ]
                },
                "productType": null,
                "productTag": {
                    "ticketPromise": null,
                    "refuseDeadline": null,
                    "ticketingTime": null,
                    "reschedulePendingTime": null,
                    "voluntaryRefundTime": null,
                    "involuntaryRefundTime": null,
                    "refundCondition": null,
                    "reissueCondition": null,
                    "voidingCondition": false,
                    "voluntaryServiceStandard": null,
                    "involuntaryServiceStandard": null,
                    "rescheduleProcessingTime": null,
                    "RBDChangedRisk": false
                },
                "productSource": "OTH",
                "fareBrand": [
                    "basic eco",
                    "basic eco"
                ],
                "posArea": [
                    "US",
                    "US"
                ],
                "RBD": [
                    "Y",
                    "Y"
                ]
            },
            {
                "offerId": "17981625171120129",
                "legId": "aaabd8d12abef43eff289cb54d0f9483",
                "currency": "USD",
                "platingCarrier": "OX",
                "pricePerPax": [
                    {
                        "paxType": "ADT",
                        "baseFare": 315.2,
                        "totalTax": 40.02,
                        "taxBreakdown": [],
                        "serviceFee": null
                    }
                ],
                "cabin": [
                    "Y",
                    "Y"
                ],
                "fareBasis": [
                    "DSVFED",
                    "DSVFED"
                ],
                "availability": [
                    "5",
                    "9"
                ],
                "extraInfo": {
                    "freeBaggageAllowance": [
                        {
                            "segmentId": "f82d1f8d50510f832be133ed56d2a0b7",
                            "cabinBagPc": "0-0-0",
                            "cabinBagSize": "e-e-e",
                            "cabinBagWeight": "0-0-0",
                            "checkedBagPc": "0-0-0",
                            "checkedBagSize": "e-e-e",
                            "checkedBagWeight": "0-0-0"
                        },
                        {
                            "segmentId": "a06798eafa401c5b028dd4f7f10178d1",
                            "cabinBagPc": "0-0-0",
                            "cabinBagSize": "e-e-e",
                            "cabinBagWeight": "0-0-0",
                            "checkedBagPc": "0-0-0",
                            "checkedBagSize": "e-e-e",
                            "checkedBagWeight": "0-0-0"
                        }
                    ]
                },
                "eligibilityFlag": true,
                "eligibilityDetail": null,
                "rules": {
                    "refund": [
                        {
                            "paxType": "ADT",
                            "couponStatus": 1,
                            "refundPolicy": "withCondition",
                            "applicableTime": [
                                null,
                                null
                            ],
                            "fullRefundAP": null,
                            "refundFee": 99
                        },
                        {
                            "paxType": "CHD",
                            "couponStatus": 1,
                            "refundPolicy": "withCondition",
                            "applicableTime": [
                                null,
                                null
                            ],
                            "fullRefundAP": null,
                            "refundFee": 99
                        }
                    ],
                    "change": [
                        {
                            "paxType": "ADT",
                            "couponStatus": 1,
                            "changePolicy": "withCondition",
                            "applicableTime": [
                                null,
                                null
                            ],
                            "changeFee": 99
                        },
                        {
                            "paxType": "CHD",
                            "couponStatus": 1,
                            "changePolicy": "withCondition",
                            "applicableTime": [
                                null,
                                null
                            ],
                            "changeFee": 99
                        }
                    ]
                },
                "productType": null,
                "productTag": {
                    "ticketPromise": null,
                    "refuseDeadline": null,
                    "ticketingTime": null,
                    "reschedulePendingTime": null,
                    "voluntaryRefundTime": null,
                    "involuntaryRefundTime": null,
                    "refundCondition": null,
                    "reissueCondition": null,
                    "voidingCondition": false,
                    "voluntaryServiceStandard": null,
                    "involuntaryServiceStandard": null,
                    "rescheduleProcessingTime": null,
                    "RBDChangedRisk": false
                },
                "productSource": "OTH",
                "fareBrand": [
                    "basic eco",
                    "basic eco"
                ],
                "posArea": [
                    "US",
                    "US"
                ],
                "RBD": [
                    "Y",
                    "Y"
                ]
            }
        ],
        "legs": [
            {
                "legId": "4ad38e31d03829dae6035cf4eb6fc972",
                "segmentIds": [
                    "cdabc75289fb9dcf917526324de0e878",
                    "82ba60be4c9f9af3c2cdb06dd78403ae"
                ]
            },
            {
                "legId": "aaabd8d12abef43eff289cb54d0f9483",
                "segmentIds": [
                    "f82d1f8d50510f832be133ed56d2a0b7",
                    "a06798eafa401c5b028dd4f7f10178d1"
                ]
            }
        ],
        "segments": [
            {
                "segmentId": "cdabc75289fb9dcf917526324de0e878",
                "duration": 1492,
                "carrier": "FD",
                "flightNo": "8750",
                "codeShare": false,
                "operatingCarrier": "FD",
                "operatingFlightNo": "FD8750",
                "aircraftCode": "空客A300",
                "depAirport": "DMK",
                "depTerminal": "T1",
                "depTime": "2024-10-24T03:18",
                "arrAirport": "SIN",
                "arrTerminal": "T2",
                "arrTime": "2024-10-25T05:10",
                "stopAirport": null,
                "stopDuration": null
            },
            {
                "segmentId": "82ba60be4c9f9af3c2cdb06dd78403ae",
                "duration": 1612,
                "carrier": "FD",
                "flightNo": "2271",
                "codeShare": false,
                "operatingCarrier": "FD",
                "operatingFlightNo": "FD2271",
                "aircraftCode": "空客A300",
                "depAirport": "SIN",
                "depTerminal": "T1",
                "depTime": "2024-11-17T03:18",
                "arrAirport": "BKK",
                "arrTerminal": "T2",
                "arrTime": "2024-11-18T05:10",
                "stopAirport": null,
                "stopDuration": null
            },
            {
                "segmentId": "f82d1f8d50510f832be133ed56d2a0b7",
                "duration": 776,
                "carrier": "OX",
                "flightNo": "8335",
                "codeShare": false,
                "operatingCarrier": "OX",
                "operatingFlightNo": "OX8335",
                "aircraftCode": "波音767",
                "depAirport": "BKK",
                "depTerminal": "T1",
                "depTime": "2024-10-24T21:58",
                "arrAirport": "SIN",
                "arrTerminal": "T2",
                "arrTime": "2024-10-25T11:54",
                "stopAirport": null,
                "stopDuration": null
            },
            {
                "segmentId": "a06798eafa401c5b028dd4f7f10178d1",
                "duration": 896,
                "carrier": "OX",
                "flightNo": "6546",
                "codeShare": false,
                "operatingCarrier": "OX",
                "operatingFlightNo": "OX6546",
                "aircraftCode": "波音767",
                "depAirport": "XSP",
                "depTerminal": "T1",
                "depTime": "2024-11-17T21:58",
                "arrAirport": "BKK",
                "arrTerminal": "T2",
                "arrTime": "2024-11-18T11:54",
                "stopAirport": null,
                "stopDuration": null
            }
        ]
    }
}
Modified at 2024-10-17 07:14:34
Previous
Error Code
Next
Pricing
Built with