Supplier selection

Let FX-Port select suppliers automatically, or pass exact supplier IDs for a special case.

Most integrations should omit supplier selectors. FX-Port filters enabled suppliers by route, traveler mix, and requested capabilities, then queries the compatible suppliers in parallel. Each successful result remains isolated under suppliers[].

Amadeus suppliers are available in the sandbox but may return errors intermittently due to Amadeus test-environment maintenance — which is outside FX-Port's control. If an Amadeus request fails in sandbox, retry or test on live. See Sandbox notice for details.

Automatic selection (recommended)

{
  "origin": "ALG",
  "destination": "CDG",
  "departure_date": "2026-09-15",
  "cabin_class": "economy",
  "passengers": { "adults": 1 }
}

Do not send supplier_id or supplier_ids. FX-Port handles supplier priority, compatibility, and new supplier activation without requiring client changes. If one supplier fails while another returns offers, the successful results are returned without a compatibility warning.

Exact supplier IDs (advanced)

Use exact IDs only for testing or a special commercial/operational requirement. Fetch current IDs from GET /api/v1/suppliers instead of hard-coding the supplier catalog.

One exact supplier

{
  "origin": "ALG",
  "destination": "CDG",
  "departure_date": "2026-09-15",
  "cabin_class": "economy",
  "passengers": { "adults": 1 },
  "supplier_id": "duffel_1"
}

Exact subset

If FX-Port has 5 enabled suppliers but you only want Amadeus Algeria and Duffel:

{
  "origin": "ALG",
  "destination": "CDG",
  "departure_date": "2026-09-15",
  "cabin_class": "economy",
  "passengers": { "adults": 1 },
  "supplier_ids": ["amadeus_aqc_dz_1", "duffel_1"]
}

Strict selection never substitutes a supplier outside the requested set. Unknown, disabled, or flexible_only-incompatible IDs return HTTP 400. A selected supplier can still be skipped when the traveler mix is incompatible, and upstream availability can prevent it from returning offers. HTTP 400 is returned for traveler compatibility only when no selected supplier remains compatible.

Strict-selection error

{
  "environment": "sandbox",
  "detail": {
    "error": "invalid_supplier_selection",
    "message": "One or more requested suppliers cannot be used for this flight search.",
    "invalidSuppliers": ["missing_1"],
    "disabledSuppliers": [],
    "unsupportedFlexibleSuppliers": [],
    "availableSuppliers": ["amadeus_aqc_dz_1", "duffel_1"]
  }
}

Omitting selectors avoids this integration maintenance and is therefore recommended.