Pricing - FlightRoutes24 API(Purchaser)

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:

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:

childNum

integer

Number of children

optional

>= 0<= 9

Default:

infantNum

integer

Number of infant passengers

optional

>= 0<= 9

Default:

Example

{
  "authentication": {
    "sign": "{{sign}}",
    "timestamp": "{{timestamp}}"
  },
  "offerId": "17981625171120128",
  "adultNum": 1,
  "childNum": 0,
  "infantNum": 0
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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
      }
    ]
  }
}