Flights API overview
FX-Port Flights API — search, price, book, hold, pay, and manage flight orders across every enabled GDS, airline, and NDC supplier.
Search, price, book, and manage flight orders across every enabled supplier from a single API surface. One request fans out to all connected GDS, NDC, LCC, and direct-airline suppliers and returns the best available fares.
New suppliers are added automatically. FX-Port continuously onboards more GDS connections, NDC channels, low-cost carriers (LCC), direct airline deals, and additional PCC / office IDs. Your existing integration automatically benefits from every new supplier and improved fare — no code changes needed. As we expand, newer API versions will deliver richer content (more fare families, fare origins, and ancillary types); those ship under a new version so your current integration keeps working.
Flight concepts
Read these before integrating — they apply to every flight endpoint.
Flight booking flows
Instant issue, hold-then-pay, and how cancellation actually works.
Flight passengers & ages
Passenger types, age rules at departure, seat vs lap infants, capacity limits.
Flight pricing
What each price field means and the b2bPrice formula.
Post-booking operations
Void, exchange, and refund — how to request them today.
Endpoints
| Method | Path | Permission | Description |
|---|---|---|---|
POST | /api/v1/get_flights | Read | Search for flights |
POST | /api/v1/flights/flexible_search | Read | Search with ±3-day flexible date matrix |
POST | /api/v1/flights/price_flight | Read | Price a cached offer (required before booking) |
POST | /api/v1/flights/book_flight | Read+Write | Create a booking (hold or instant issue) |
POST | /api/v1/flights/get_order_quote | Read | Get current price/status for a held order |
POST | /api/v1/flights/pay_order | Read+Write | Pay and issue tickets for a held order |
POST | /api/v1/flights/cancel_order | Read+Write | Cancel a held (unpaid) reservation to release the PNR |
POST | /api/v1/flights/get_booking | Read | Retrieve booking details (includes PDF link) |
POST | /api/v1/flights/get_ticket | Read | Download ticket PDF |
GET | /api/v1/flights/airports | Public | Search airports by name or IATA code |
Important notes
Hold warning — Holding a flight can prevent creating another booking for the same passenger
on the same airline/route with some GDS suppliers. If you no longer need a hold, cancel it
(cancel_order) to release the PNR before trying again. A displayed deadline is not a guarantee:
an airline can release the PNR early, and only a successful pay_order confirms issuance. See
Cancelling a held reservation.
Fee accuracy — Exchange fees, refund fees, and penalties returned in conditions are
indicative and may differ from what is actually charged. Communicate to travellers that a
ticket is "refundable for a fee" or "changeable for a fee" rather than quoting exact amounts.
Error responses
| HTTP | Cause |
|---|---|
401 | Missing or invalid API key |
403 | Key lacks write permission for this operation |
404 | Search ID, offer ID, or booking not found |
410 | Offer expired and is no longer available (re-search) |
503 | Supplier API temporarily unavailable |
Questions?
Email the FX-Port developer team at [email protected] for integration help, feature requests, or to report an API error. For void, exchange, re-issue, or refund requests, use Request support on the booking confirmation page in the FX-Port dashboard or email [email protected].