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

Introduction

API Description#

FlightRoutes24®(as same as FR24 in below texts) provides 11 functions of APIs to Sub-Agents.
APIDescription
shoppingFlight Search API, pairs with O/D city pair and date in RQ. Then gets all possible flight combinations results in RS.
pricingVerify API, organizes the RQ with a specific flight option from Search RS. Then gets the latest accurate Price, Tax, and Availability for the specific flight.
bookingBooking API, calls this API with a specific flight option and passenger info details, contact information, FR24 would reserve the seat(s) for the user, and create a Booking for this transaction. NOTE: FR24 does not support user to cancel a booking by himself. If the user doesn’t take further action of Booking, then the order will be canceled by FR24 system automatically. That means, if the Booking status has not been changed to Ticketing Processing by user (triggered by Ticketing API calls or manual action on the portal), FR24’s system would cancel the order eventually.
ticketingUser should submit total price and booking number for the booking in the RQ to trigger ticketing process. Requesting the API of Ticketing successfully only means FR24 has received the ticketing application, and it will be pending rather than being instantly confirmed and issued. FR24 will notify the order status change via orderChangeInforming API if the booking is confirmed and the ticket can be issued. User could receive every booking’s and passenger’s e-ticket number by three methods below: 1. Developing an orderChangeInforming API with FR24’s method, which would receive pushing notification sent from FR24 with info including e-ticket number automatically and timely. 2. Calling orderDetail API in a 5-30 minute frequency, once ticket is issued successfully, FR24 would update info including e-ticket number into order Details. 3. Visiting b2b.flightroutes24.com website to check manually.
orderDetailFor API “orderDetail” and API “orderChangeInforming”, please at least choose one of them for integration. Order Details is another solution to get information in RS with e-ticket number, booking/order status, and all booking details.
orderChangeInformingFor API “orderDetail” and API“orderChangeInforming”, please at least choose one of them for integration. The API for getting order changed information, including e-ticket number, airline PNR, order status and schedule change. This API is a reverse workflow API, which user needs to develop a FR24’s method and provides a URL that allow FR24 update information to user. NOTE: Requesting the API of Ticketing successfully only means FR24 has received the ticketing application, and it will be pending rather than being instantly confirmed and issued. FR24 will notify the order status change via orderChangeInforming API if the booking is confirmed and the ticket can be issued.
presaleAncillaryShoppingSearch for ancillary products that can be added and ordering with tickets.
postsaleAncillaryShoppingSearch for ancillary products that can be added after the order being created.
ancillaryBookingCreate an ancillary order to reserve the ancillary products.
ancillaryPurchasePost-sales ancillary order payment.
ancillaryOrderDetailGet post-sales ancillary order details.
changeReshopSearch for available rescheduling flight
reissueRequestRescheduling confirmation
refundRequestRefund Request Interface. By invoking the refundRequest interface, a refund pricing application will be initiated to FR24. The pricing result will be pushed through the orderChangeInforming API
refundConfirmConfirmation of Refund Interface. By invoking the refundConfirm interface, FR24 will be notified to process the refund. It supports two scenarios: Call this interface to initiate a refund after pricing is completed.Support directly calling this interface to initiate a refund.
voidRequestTicket void request.

Getting started#

• We provide API https to visit URL, the Unicode is UTF-8
• The https API requests content-Type="application/json"
• API requests API URL and send the body that conforms to the JSON specification through "https post".

Create an application account#

Contact FR24 account manager to create an account , and get API access permissions.

Header#

The requests and responses are G-zipped and need to be unpacked (request header Accept-Encoding: gzip).
NameDescription
appkeyUser account
Accept-Encodinggzip
content-Typeapplication/json

User authentication#

The API uses appkey authentication and IP whitelist authentication mechanisms. Partners need to provide IP address lists for FR24 to complete identity authentication.
Appkey and corresponding appSecret are assigned by FR24.
If partner requires the IP list of FR24, please contact FR24 business manager.

Production environment links#

The PROD. environment link will be provided by the business manager after the test is completed.
Modified at 2024-10-14 08:03:33
Previous
API Work Flow
Next
Appendix
Built with