Account · Suppliers

List suppliers

List the suppliers that are enabled for your key, grouped by product: flights, hotels and eSIMs.

GET/api/v1/suppliers

Requires an API key with Read permission; a Read+Write key works too.

A product with no enabled supplier is left out, and so are disabled suppliers. The list can change at any time: read it, do not hard-code it. Flight suppliers carry routes, capabilities and void_deadline; hotel and eSIM suppliers only id, name, technology and description.

void_deadline is the next midnight in the supplier's time zone, in UTC, recalculated on every call: do not keep it across days. The supplier id is the one to send as supplier_id where an endpoint takes one. The bookings of your account carry their own supplierId, which can differ (ratehawk for worldota_1, airalo for airalo_1).

curl https://api.fx-port.com/api/v1/suppliers \
  -H "Authorization: Bearer fxp_test_YOUR_KEY"

Response200

{
  "environment": "sandbox",
  "success": true,
  "products": [
    {
      "product": "flights",
      "suppliers": [
        {
          "id": "amadeus_aqc_dz_1",
          "name": "Amadeus Algeria",
          "technology": "amadeus_aqc",
          "routes": [
            "DZ"
          ],
          "description": "Operates on routes from and to Algeria using a dedicated Algiers GDS office with negotiated fares. Benefits from an advantageous DZD exchange rate that typically results in significantly lower prices on outbound Algeria routes ...",
          "capabilities": {
            "hold": true,
            "void": true,
            "flexible_dates": true,
            "ancillaries": false
          },
          "voidDeadline": "2026-11-01T23:00:00Z",
          "void_deadline": "2026-11-01T23:00:00Z"
        },
        {
          "id": "duffel_1",
          "name": "Duffel",
          "technology": "duffel",
          "routes": [
            "*"
          ],
          "description": "TravelPort-connected supplier with broad global route coverage across hundreds of airlines at published fares. Particularly competitive on European, Middle Eastern, and long-haul routes ...",
          "capabilities": {
            "hold": false,
            "void": false,
            "flexible_dates": false,
            "ancillaries": true
          },
          "voidDeadline": "2026-11-02T00:00:00Z",
          "void_deadline": "2026-11-02T00:00:00Z"
        }
      ]
    },
    {
      "product": "hotels",
      "suppliers": [
        {
          "id": "worldota_1",
          "name": "RateHawk",
          "technology": "worldota",
          "description": "Aggregates hotel inventory from global hotel chains and independent properties across leisure and business destinations worldwide. Broad coverage across leisure and business destinations with real-time availability and net rates."
        }
      ]
    },
    {
      "product": "esims",
      "suppliers": [
        {
          "id": "airalo_1",
          "name": "Airalo",
          "technology": "airalo",
          "description": "Global eSIM data provider with coverage across 190+ countries and regions. Data plans are activated instantly and the eSIM QR code is delivered directly to the customer's email address after purchase."
        }
      ]
    }
  ],
  "meta": {
    "environment": "sandbox",
    "permissionRequired": "read",
    "permission_required": "read"
  }
}

Request

This endpoint takes no parameters.

Response

200The enabled suppliers, by product.

successboolean

true when the list was returned.

productsarray of object

One entry per product that has at least one enabled supplier.

ShowHide 2 attributes

productstring

The product.

One of flights, hotels, esims.

suppliersarray of object

The enabled suppliers of the product.

ShowHide 8 attributes

idstring

The id of the supplier. Send it as supplier_id where an endpoint takes one.

namestring

The name of the supplier.

technologystring

How FX-Port connects to the supplier: for example amadeus_aqc, duffel, worldota or airalo. New values appear when connections are added.

routesarray of string

Flights only. The markets the supplier serves.

descriptionstring

What the supplier is good for. Free text: it can change.

capabilitiesobject

What a flight supplier supports.

ShowHide 4 attributes

holdboolean

Flights. The supplier can hold a booking to pay later.

voidboolean

Flights. The supplier can void an issued ticket on the day of issue.

flexible_datesboolean

Flights. The supplier supports the flexible-dates search.

ancillariesboolean

Flights. The supplier sells extras such as seats and bags.

voidDeadlinestringdeprecated

Legacy name, still accepted. Use void_deadline instead.

Flights only, for suppliers that can void. The next cut-off for a void, in UTC: the next midnight in the supplier's time zone. It is recalculated on every request. The older name of void_deadline: same value, use void_deadline.

void_deadlinestring

Flights only, for suppliers that can void. The next cut-off for a void, in UTC: the next midnight in the supplier's time zone. It is recalculated on every request. The snake_case twin of voidDeadline, with the same value: use this name.

metaobject

Facts about the answer.

ShowHide 3 attributes

environmentstring

The environment of the key that made the call: sandbox for fxp_test_ keys, live for fxp_live_ keys. Present in every JSON body.

One of sandbox, live.

permissionRequiredstringdeprecated

Legacy name, still accepted. Use permission_required instead.

read: the permission the endpoint needs. The older name of permission_required: same value, use permission_required.

permission_requiredstring

read: the permission the endpoint needs. The snake_case twin of permissionRequired, with the same value: use this name.

{ "environment": "sandbox", "success": true, "products": [ { "product": "flights", "suppliers": [ { "id": "amadeus_aqc_dz_1", "name": "Amadeus Algeria", "technology": "amadeus_aqc", "routes": [ "DZ" ], "description": "Operates on routes from and to Algeria using a dedicated Algiers GDS office with negotiated fares. Benefits from an advantageous DZD exchange rate that typically results in significantly lower prices on outbound Algeria routes ...", "capabilities": { "hold": true, "void": true, "flexible_dates": true, "ancillaries": false }, "voidDeadline": "2026-11-01T23:00:00Z", "void_deadline": "2026-11-01T23:00:00Z" }, { "id": "duffel_1", "name": "Duffel", "technology": "duffel", "routes": [ "*" ], "description": "TravelPort-connected supplier with broad global route coverage across hundreds of airlines at published fares. Particularly competitive on European, Middle Eastern, and long-haul routes ...", "capabilities": { "hold": false, "void": false, "flexible_dates": false, "ancillaries": true }, "voidDeadline": "2026-11-02T00:00:00Z", "void_deadline": "2026-11-02T00:00:00Z" } ] }, { "product": "hotels", "suppliers": [ { "id": "worldota_1", "name": "RateHawk", "technology": "worldota", "description": "Aggregates hotel inventory from global hotel chains and independent properties across leisure and business destinations worldwide. Broad coverage across leisure and business destinations with real-time availability and net rates." } ] }, { "product": "esims", "suppliers": [ { "id": "airalo_1", "name": "Airalo", "technology": "airalo", "description": "Global eSIM data provider with coverage across 190+ countries and regions. Data plans are activated instantly and the eSIM QR code is delivered directly to the customer's email address after purchase." } ] } ], "meta": { "environment": "sandbox", "permissionRequired": "read", "permission_required": "read" } }

Response

200The enabled suppliers, by product.

successboolean

true when the list was returned.

productsarray of object

One entry per product that has at least one enabled supplier.

ShowHide 2 attributes

productstring

The product.

One of flights, hotels, esims.

suppliersarray of object

The enabled suppliers of the product.

ShowHide 8 attributes

idstring

The id of the supplier. Send it as supplier_id where an endpoint takes one.

namestring

The name of the supplier.

technologystring

How FX-Port connects to the supplier: for example amadeus_aqc, duffel, worldota or airalo. New values appear when connections are added.

routesarray of string

Flights only. The markets the supplier serves.

descriptionstring

What the supplier is good for. Free text: it can change.

capabilitiesobject

What a flight supplier supports.

ShowHide 4 attributes

holdboolean

Flights. The supplier can hold a booking to pay later.

voidboolean

Flights. The supplier can void an issued ticket on the day of issue.

flexible_datesboolean

Flights. The supplier supports the flexible-dates search.

ancillariesboolean

Flights. The supplier sells extras such as seats and bags.

voidDeadlinestringdeprecated

Legacy name, still accepted. Use void_deadline instead.

void_deadlinestring

metaobject

Facts about the answer.

ShowHide 3 attributes

environmentstring

The environment of the key that made the call: sandbox for fxp_test_ keys, live for fxp_live_ keys. Present in every JSON body.

One of sandbox, live.

permissionRequiredstringdeprecated

Legacy name, still accepted. Use permission_required instead.

read: the permission the endpoint needs. The older name of permission_required: same value, use permission_required.

permission_requiredstring

read: the permission the endpoint needs. The snake_case twin of permissionRequired, with the same value: use this name.

Request

Response

Related guides

Request

Response

Related guides