Skip to content
FX-Port/Docs
GuidesAPI referenceChangelog
Get API keys
  • Introduction
  • Quickstart
  • Security
  • Authentication
  • Environments and Postman
  • Sandbox
  • Conventions and naming
  • Legacy names and twins
  • Errors
  • Rate limits and fair use
  • Streaming search results
  • Use these docs with AI

Get started

Environments and Postman

Live and sandbox on one base URL, decided by the API key prefix, and the Postman collections to try every endpoint.

There is one base URL for all environments:

https://api.fx-port.com

The environment is determined entirely by the API key prefix — there are no separate URLs. Every JSON answer starts with "environment": "sandbox" or "live" and every response carries the X-Environment header, so your code can assert which environment it is talking to. (An answer to a request with a missing or unknown key says live, because the environment of an unknown key cannot be known.)

Key prefixEnvironmentBehaviour
fxp_live_LiveReal agency data; debits real balance; real bookings
fxp_test_SandboxIsolated test bookings; no real charges; balance endpoints return empty

Getting API keys

Create keys in the FX-Port dashboard at fx-port.com/dashboard/api.

Both sandbox and live keys can have Read or Read+Write permissions:

PermissionSandbox key useLive key use
ReadSearch, price, get quotes, retrieve bookingsSame
Read+WriteSearch + create test bookings, pay, cancelSearch + real bookings, real balance debit

Postman collections

Pre-built collections with every endpoint, auto-wired test scripts (a search saves search_id and offer_id for the price and book requests that follow), and randomised Latin passenger names. Download, import into Postman, set your API key as the api_key variable, and every request is ready to run. The collections contain no API keys — add your own. They are generated from the same description of the API as the reference, so they always match it.

Two environment files set base_url and api_key for you: FX-Port-Sandbox.postman_environment.json and FX-Port-Live.postman_environment.json. To import the whole API at once instead, give Postman (or Insomnia, Bruno, Swagger UI ...) the OpenAPI file: https://fx-port.com/openapi.json.

Flights collectionSearch, price, book, hold/pay, cancel, get booking, get ticket, airports.Hotels collectionLocation/name lookup, availability search, rates, pre-book, booking, voucher, and cancellation.eSIMs collectionPackage catalog, compatible devices, orders, topups, usage, bookings, and installation instructions.Account collectionBalances, financial ledger, and booking history.Suppliers collectionDiscover enabled suppliers and capabilities.

Direct links:

  • FX-Port-Flights.postman_collection.json
  • FX-Port-Hotels.postman_collection.json
  • FX-Port-eSIMs.postman_collection.json
  • FX-Port-Account.postman_collection.json
  • FX-Port-Suppliers.postman_collection.json

Get your API keys at fx-port.com/dashboard/api — sandbox keys are free.

PreviousAuthenticationNext Sandbox

On this page

  • Getting API keys
  • Postman collections

© 2026 FX-Port

TermsPrivacy[email protected]