FR24 OpenAPI
  1. API Reference
FR24 OpenAPI
  • FR24_API_V2.0
    • Guides
      • API Work Flow
      • Introduction
      • Appendix
      • Error Code
    • API Reference
      • OrderChangeInforming
      • Shopping
        POST
      • Pricing
        POST
      • Booking
        POST
      • Ticketing
        POST
      • OrderDetail
        POST
      • PresaleAncillaryShopping
        POST
      • PostsaleAncillaryShopping
        POST
      • seatMap
        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

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
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
seriesTraceId
string 
The traceId returned by the last service request interface
optional
This field is a developer option. FR24 uses this traceId to track and analyze the last call interface of the partner, so that both parties can quickly track the entire link when problems occur.
seriesRsTime
number 
The last service request interface, the time from requesting the interface to obtaining the result, in ms
optional
This field is a developer option. FR24 uses this time to analyze the partner's network delay to improve the data quality of both parties.
Example
{
  "authentication": {
    "sign": "",
    "timestamp": ""
  },
  "offerId": "a17f56079af111ca6278d72124595910",
  "adultNum": 2,
  "childNum": 0,
  "infantNum": 0,
  "seriesTraceId": "shop_202410101503481394",
  "seriesRsTime": 5
}

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" : "a17f56079af111ca6278d72124595910",
    "adultNum" : 2,
    "childNum" : 0,
    "infantNum" : 0,
    "seriesTraceId": "shop_202410101503481394",
    "seriesRsTime": 5
}'

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
>= 0
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.
Examples
{
  "traceId": "verify_NEWAPI2309111710329910910",
  "code": "000000",
  "message": "success",
  "processingTime": 477,
  "data": {
    "offer": [
      {
        "offerId": "15803139091927040",
        "legId": "55623c5bf92ccd6d3cf30b543c0bd5ad",
        "currency": "CNY",
        "platingCarrier": "IJ",
        "pricePerPax": [
          {
            "paxType": "ADT",
            "baseFare": 2316,
            "totalTax": 1982,
            "taxBreakdown": [],
            "serviceFee": null
          }
        ],
        "cabin": [
          "Y"
        ],
        "fareBasis": [
          null
        ],
        "availability": [
          "2"
        ],
        "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",
        "totalPrice": 8596,
        "paxInfoRequired": {
          "birthday": true,
          "gender": true,
          "cardNum": true,
          "cardType": true,
          "cardIssuedPlace": true,
          "cardExpiryDate": true,
          "nationality": true,
          "paxEmail": true,
          "paxMobile": true,
          "areaCode": true
        },
        "RBD": [
          "K"
        ]
      }
    ],
    "legs": {
      "legId": "55623c5bf92ccd6d3cf30b543c0bd5ad",
      "segmentIds": [
        "d50b31d910612e8edb45b9466649a3a3"
      ]
    },
    "segments": [
      {
        "segmentId": "d50b31d910612e8edb45b9466649a3a3",
        "duration": 142,
        "carrier": "IJ",
        "flightNo": "5817",
        "codeShare": false,
        "operatingCarrier": null,
        "operatingFlightNo": null,
        "aircraftCode": "333",
        "depAirport": "SIN",
        "depTerminal": null,
        "depTime": "2023-11-15T00:25",
        "arrAirport": "HKG",
        "arrTerminal": null,
        "arrTime": "2023-11-15T02:47",
        "stopAirport": null,
        "stopDuration": null
      }
    ]
  }
}
Modified at 2025-02-12 07:45:40
Previous
Shopping
Next
Booking
Built with