GET /api/v1/suppliers

Discover every enabled supplier across all products — GDS, NDC, LCC and direct airlines — with capabilities and void deadlines.

Returns all enabled suppliers grouped by product. This endpoint spans all products (flights, hotels, eSIMs), not just flights. Disabled suppliers and unimplemented products are omitted.

Permission: Read

The supplier list grows over time. FX-Port continuously adds GDS connections, NDC channels, low-cost carriers, direct-airline deals, and additional PCC / office IDs. Your integration picks up new suppliers automatically — no code change needed. Treat this list as dynamic; do not hard-code it.

Request

curl --request GET \
  --url https://api.fx-port.com/api/v1/suppliers \
  --header 'Authorization: Bearer fxp_live_YOUR_KEY'

Response example

{
  "environment": "live",
  "success": true,
  "products": [
    {
      "product": "flights",
      "suppliers": [
        {
          "id": "amadeus_aqc_dz_1",
          "name": "Amadeus Algeria",
          "technology": "amadeus_aqc",
          "routes": ["DZ", "*"],
          "description": "Dedicated Algiers GDS office with negotiated fares and an advantageous DZD rate on outbound Algeria routes. Supports hold reservations and same-day void.",
          "capabilities": {
            "hold": true,
            "void": true,
            "flexible_dates": true,
            "ancillaries": false
          },
          "voidDeadline": "2026-08-17T23:00:00Z"
        },
        {
          "id": "amadeus_aqc_tn_1",
          "name": "Amadeus Tunisia",
          "technology": "amadeus_aqc",
          "routes": ["TN", "*"],
          "description": "Tunis GDS office with negotiated North-Africa and European fares priced in TND. Supports hold and same-day void within the Tunis ticketing day.",
          "capabilities": {
            "hold": true,
            "void": true,
            "flexible_dates": true,
            "ancillaries": false
          },
          "voidDeadline": "2026-08-17T23:00:00Z"
        },
        {
          "id": "ndc_eg_1",
          "name": "NDC Egypt",
          "technology": "ndc",
          "routes": ["EG", "*"],
          "description": "Direct NDC content for Egyptian carriers with richer fare families and continuous pricing. Fares in EGP. Ancillary bundles available on supported carriers.",
          "capabilities": {
            "hold": false,
            "void": false,
            "flexible_dates": false,
            "ancillaries": true
          }
        },
        {
          "id": "travelport_uk_1",
          "name": "TravelPort UK",
          "technology": "travelport",
          "routes": ["GB", "*"],
          "description": "TravelPort-connected UK office with broad European and long-haul coverage at published fares. Competitive on UK-origin itineraries. Seat and bag ancillaries on supported carriers.",
          "capabilities": {
            "hold": false,
            "void": false,
            "flexible_dates": false,
            "ancillaries": true
          }
        },
        {
          "id": "travelport_ae_1",
          "name": "TravelPort UAE",
          "technology": "travelport",
          "routes": ["AE", "*"],
          "description": "Dubai TravelPort office with strong Gulf, Indian-subcontinent, and long-haul coverage. Fares in AED. Ancillaries available on supported carriers.",
          "capabilities": {
            "hold": false,
            "void": false,
            "flexible_dates": false,
            "ancillaries": true
          }
        },
        {
          "id": "sabre_us_1",
          "name": "Sabre USA",
          "technology": "sabre",
          "routes": ["US", "*"],
          "description": "Sabre-connected US office with deep North-American and transatlantic inventory at published fares. Broad carrier coverage; ancillaries on supported airlines.",
          "capabilities": {
            "hold": false,
            "void": false,
            "flexible_dates": false,
            "ancillaries": true
          }
        },
        {
          "id": "duffel_1",
          "name": "Duffel",
          "technology": "duffel",
          "routes": ["*"],
          "description": "Aggregated global content across hundreds of airlines at published fares. Competitive on European, Middle-Eastern, and long-haul routes. Seat and bag ancillaries on supported carriers. Holds not supported.",
          "capabilities": {
            "hold": false,
            "void": false,
            "flexible_dates": false,
            "ancillaries": true
          }
        }
      ]
    },
    {
      "product": "hotels",
      "suppliers": [
        {
          "id": "worldota_1",
          "name": "RateHawk",
          "technology": "worldota",
          "description": "Global hotel inventory from chains and independents with real-time availability and net rates."
        }
      ]
    },
    {
      "product": "esims",
      "suppliers": [
        {
          "id": "airalo_1",
          "name": "Airalo",
          "technology": "airalo",
          "description": "eSIM data plans across 190+ countries, activated instantly with QR delivery by email."
        }
      ]
    }
  ],
  "meta": {
    "environment": "live",
    "permissionRequired": "read"
  }
}

Field reference

Common supplier fields

Field	Type	Description
`id`	string	Supplier identifier — pass as `supplier_id` in search/booking requests
`name`	string	Human-readable supplier name
`technology`	string	Underlying integration technology (see below)
`description`	string	Supplier characteristics, strengths, and operational notes

Integration technologies

The technology field indicates how FX-Port connects to the supplier. Current values include:

Technology	Meaning
`amadeus_aqc`	Amadeus Quick Connect (dedicated office / negotiated fares)
`amadeus_soap`	Amadeus classic SOAP / Web Services
`travelport`	TravelPort (Galileo / Apollo / Worldspan)
`sabre`	Sabre GDS
`ndc`	Direct airline NDC content
`duffel`	Duffel aggregated content
`worldota`	WorldOTA / RateHawk (hotels)
`airalo`	Airalo (eSIMs)

New technologies are added as connections come online — do not hard-code this list.

Flight-specific fields

Field	Type	Description
`routes`	array	Market scope. A country code (e.g. `"DZ"`, `"TN"`, `"GB"`) means that origin is prioritised; `"*"` means global coverage.
`capabilities.hold`	boolean	Supports hold (reserve now, pay later)
`capabilities.void`	boolean	Supports same-day void of issued tickets
`capabilities.flexible_dates`	boolean	Supports the ±3-day flexible date matrix
`capabilities.ancillaries`	boolean	Supports ancillary upsells (seats, extra bags)
`voidDeadline`	string	Next void cutoff (UTC) — next midnight in the supplier's timezone

The `voidDeadline` field

voidDeadline is recalculated on every request — do not cache it across days. It is the next midnight in the supplier's operating timezone, expressed in UTC. Void eligibility varies by supplier and airline — check it immediately before attempting a void.