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

Pricing

POST
/api/new/pricing.do
Through calling Pricing API, partner can obtain the latest price and seating information according to the offerId provided by the Shopping RS.
Notes: Partner shall not use this API to build/update your cache, if partner’s pricing-booking conversion rate is lower than average, we will push partner to optimize process between us until the rate is reasonable.

Request

Header Params
Accept-Encoding
string 
required
Use gzip compression format
Default:
gzip, deflate, br
content-Type
string 
required
Response format
Default:
application/json
appKey
string 
required
User account
Default:
{{appKey}}
Body Params application/json
authentication
object 
User authentication
required
sign
string 
Signature
required
The encrypted string of appkey, appSecret and timestamp.Refer to Appendix I
timestamp
string 
Unix timestamp
required
measuring in Second
offerId
string 
shoppingRS returns the unique identifier offerId
required
shoppingRS returns the unique identifier offerId
adultNum
integer 
The total number of adult passenger
required
The sum of adults, children and infants cannot be greater than 9.
>= 1<= 9
Default:
0
childNum
integer 
Number of children
optional
>= 0<= 9
Default:
0
infantNum
integer 
Number of infant passengers
optional
>= 0<= 9
Default:
0
Example
{
    "authentication": {
        "sign": "{{sign}}",
        "timestamp": "{{timestamp}}"
    },
    "offerId": "17981625171120128",
    "adultNum": 1,
    "childNum": 0,
    "infantNum": 0
}

Request 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/pricing.do' \
--header 'Accept-Encoding;' \
--header 'appKey;' \
--header 'content-Type: application/json' \
--data-raw '{
    "authentication": {
        "sign": "",
        "timestamp": ""
    },
    "offerId": "17981625171120128",
    "adultNum": 1,
    "childNum": 0,
    "infantNum": 0
}'

Responses

🟢200OK
application/json
Body
traceId
string 
Traceability code
required
traceId can help locate problems when problems occur between partners and FR24.
code
string 
Status code
required
000000 means success, others mean failure.
message
string 
Error code message
required
processingTime
number 
Processing time
required
measuring in ms
data
object 
All the data returned according to the Request
optional
If code returns failure, this field would be empty.
offer
array [object {18}] 
Price information
required
returns combination of direct flight and transit.
legs
object (Itinerary information) 
Itinerary information
required
returns all flight combination.
segments
array [object {16}] 
Flight information
required
returns all non-duplicated segments.
Example
{
    "traceId": "verify_NEWAPI24093010483215707703",
    "code": "000000",
    "message": "ok",
    "processingTime": 411,
    "data": {
        "offer": [
            {
                "offerId": "17981626452283392",
                "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"
                ],
                "totalPrice": 355.22,
                "paxInfoRequired": {
                    "birthday": true,
                    "gender": true,
                    "cardNum": true,
                    "cardType": true,
                    "cardIssuedPlace": true,
                    "cardExpiryDate": true,
                    "nationality": true,
                    "paxEmail": false,
                    "paxMobile": false,
                    "areaCode": false
                },
                "RBD": [
                    "Y",
                    "Y"
                ]
            }
        ],
        "legs": {
            "legId": "4ad38e31d03829dae6035cf4eb6fc972",
            "segmentIds": [
                "cdabc75289fb9dcf917526324de0e878",
                "82ba60be4c9f9af3c2cdb06dd78403ae"
            ]
        },
        "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
            }
        ]
    }
}
Modified at 2025-04-17 06:24:00
Previous
Shopping
Next
PresaleAncillaryShopping
Built with