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

changeReshop

POST
/api/new/changeReshop.do
Calling changeReshop to get offers in case the client wants to change date/time, change route or cabin of a confirmed booking. Client will get offers in the response of changeReshop.
Note: Rerouting enables customers to make changes to the same origin and destination airports.

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
orderNo
string 
FR24 ticketing order number
required
Match pattern:
^\d*$
originalSegments
array[object (Original flight segment information) {3}] 
Original flight segment information
required
carrier
string 
Airline IATA code
required
flightNo
string 
Flight number
required
depTime
string <date-time>
Departure time
required
YYYY-MM-DDTHH:mm
newLegs
array[object (Searching for segment information) {5}] 
New rescheduled flight segment information
required
origin
string 
Departure city
required
code by IATA
>= 3 characters<= 3 characters
typeO
enum<string> 
The origin type restrictions
optional
Allowed values:
airportcodeairportgroup
destination
string 
Arrival city
required
code by IATA
>= 3 characters<= 3 characters
typeD
enum<string> 
The destination type restrictions
optional
Allowed values:
airportcodeairportgroup
depDate
string <date>
Departure date
required
格式：YYYY-MM-DD
>= 10 characters<= 10 characters
Match pattern:
^\d{4}-\d{2}-\d{2}$
adultNum
integer 
Number of adult passengers
required
childNum
integer 
Number of child passengers
optional
infantNum
integer 
Number of infant passengers
optional
preferences
object 
Preferences
optional
Cabin class provided only
cabin
enum<string> 
Cabin class preference
optional
If not specified, it will default to the cabin class of the original booking.
Allowed values:
FCPY
Example
{
    "authentication": {
        "sign": "{{sign}}",
        "timestamp": "{{time}}"
    },
    "orderNo": "{{orderNo_detail}}",
    "originalSegments": [
        {
            "carrier": "{{carrier_detail}}",
            "flightNo": "{{flightNo_detail}}",
            "depTime": "{{depTime_detail}}"
        }
    ],
    "newLegs": [
        {
            "origin": "SIN",
            "destination": "HKG",
            "depDate": "2024-04-16"
        },
        {
            "origin": "HKG",
            "destination": "SIN",
            "depDate": "2024-04-22"
        }
    ],
    "adultNum": 1,
    "childNum": 0,
    "infantNum": 0,
    "preferences": {
        "cabin": ""
    }
}

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/changeReshop.do' \
--header 'Accept-Encoding;' \
--header 'appKey;' \
--header 'content-Type: application/json' \
--data-raw '{
    "authentication": {
        "sign": "",
        "timestamp": "{{time}}"
    },
    "orderNo": "{{orderNo_detail}}",
    "originalSegments": [
        {
            "carrier": "{{carrier_detail}}",
            "flightNo": "{{flightNo_detail}}",
            "depTime": "{{depTime_detail}}"
        }
    ],
    "newLegs": [
        {
            "origin": "SIN",
            "destination": "HKG",
            "depDate": "2024-04-16"
        },
        {
            "origin": "HKG",
            "destination": "SIN",
            "depDate": "2024-04-22"
        }
    ],
    "adultNum": 1,
    "childNum": 0,
    "infantNum": 0,
    "preferences": {
        "cabin": ""
    }
}'

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
required
If code returns failure, the field would be empty.
offers
array [object {6}] 
Quotation information
required
Each itinerary has the option to change flight combinations.
segments
array [object {16}] 
Segment information
required
including all unique flight details.
Example
{
    "traceId": "",
    "code": "000000",
    "message": "success",
    "processingTime": "",
    "data": {
        "offers": [
            {
                "offerId": "16714275498827776",
                "currency": "CNY",
                "legs": [
                    {
                        "legId": "6569cc7f11c26f09901f5af0063aff8c",
                        "segmentIds": [
                            "cc3e76f1df8f841e7592e9a295c503b0",
                            "2895534648b7bca1b1f9acfeadf89271"
                        ]
                    }
                ],
                "changeFee": [
                    {
                        "legId": "6569cc7f11c26f09901f5af0063aff8c",
                        "paxType": "ADT",
                        "baseFare": "2000.00",
                        "totalTax": "12.00",
                        "taxBreakdown": [
                            {
                                "taxType": "",
                                "taxAmount": 12
                            }
                        ],
                        "baseFareDiff": "200.00",
                        "totalTaxDiff": "2.00",
                        "changeFee": "50.00",
                        "noshow": "0.00",
                        "serviceFee": null,
                        "totalFare": "252.00"
                    }
                ],
                "cabin": "Y",
                "RBD": "Q"
            },
            {
                "offerId": "15803089789194240",
                "currency": "CNY",
                "legs": [
                    {
                        "legId": "e3504f0918ff9594ec8537663b02f925",
                        "segmentIds": [
                            "2895534648b7bca1b1f9acfeadf89272",
                            "cc3e76f1df8f841e7592e9a295c503b1"
                        ]
                    }
                ],
                "changeFee": [
                    {
                        "legId": "e3504f0918ff9594ec8537663b02f925",
                        "paxType": "ADT",
                        "baseFare": "2017.30",
                        "totalTax": "4.00",
                        "taxBreakdown": [
                            {
                                "taxType": "",
                                "taxAmount": 4
                            }
                        ],
                        "baseFareDiff": "217.30",
                        "totalTaxDiff": "0.00",
                        "changeFee": "40.00",
                        "noshow": "0.00",
                        "serviceFee": null,
                        "totalFare": "257.30"
                    }
                ],
                "cabin": "Y",
                "RBD": "Q"
            }
        ],
        "segments": [
            {
                "segmentId": "cc3e76f1df8f841e7592e9a295c503b0",
                "duration": 93,
                "carrier": "FR",
                "flightNo": "953",
                "aircraftCode": "Boeing 777",
                "depAirport": "SIN",
                "depTerminal": null,
                "depTime": "2024-04-16T08:33",
                "arrAirport": "HKG",
                "arrTerminal": null,
                "arrTime": "2024-04-16T11:30",
                "stopAirport": [],
                "stopDuration": []
            },
            {
                "segmentId": "2895534648b7bca1b1f9acfeadf89271",
                "duration": 213,
                "carrier": "PG",
                "flightNo": "688",
                "aircraftCode": "Boeing 777",
                "depAirport": "HKG",
                "depTerminal": null,
                "depTime": "2024-04-22T05:06",
                "arrAirport": "SIN",
                "arrTerminal": null,
                "arrTime": "2024-04-22T08:00",
                "stopAirport": [],
                "stopDuration": []
            },
            {
                "segmentId": "2895534648b7bca1b1f9acfeadf89272",
                "duration": "93",
                "carrier": "FR",
                "flightNo": "953",
                "aircraftCode": "Boeing 777",
                "depAirport": "SIN",
                "depTerminal": null,
                "depTime": "2024-04-16T14:20",
                "arrAirport": "HKG",
                "arrTerminal": null,
                "arrTime": "2024-04-16T16:50",
                "stopAirport": [],
                "stopDuration": []
            },
            {
                "segmentId": "cc3e76f1df8f841e7592e9a295c503b1",
                "duration": 213,
                "carrier": "PG",
                "flightNo": "688",
                "aircraftCode": "Boeing 777",
                "depAirport": "HKG",
                "depTerminal": null,
                "depTime": "2024-04-22T10:06",
                "arrAirport": "SIN",
                "arrTerminal": null,
                "arrTime": "2024-04-22T13:05",
                "stopAirport": [],
                "stopDuration": []
            }
        ]
    }
}
Modified at 2025-06-12 09:40:23
Previous
ancillaryOrderDetail
Next
reissueRequest
Built with