# List suppliers

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

Endpoint: `GET /suppliers`

Source: https://fx-port.com/docs/api/list-suppliers

`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`).

## Request

### Example request

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

## Response

### 200: The enabled suppliers, by product.

- `success` (boolean): `true` when the list was returned.
- `products` (array of object): One entry per product that has at least one enabled supplier.
  - `product` (string): The product. One of `flights`, `hotels`, `esims`.
  - `suppliers` (array of object): The enabled suppliers of the product.
    - `id` (string): The id of the supplier. Send it as `supplier_id` where an endpoint takes one.
    - `name` (string): The name of the supplier.
    - `technology` (string): How FX-Port connects to the supplier: for example `amadeus_aqc`, `duffel`, `worldota` or `airalo`. New values appear when connections are added.
    - `routes` (array of string): Flights only. The markets the supplier serves.
    - `description` (string): What the supplier is good for. Free text: it can change.
    - `capabilities` (object): What a flight supplier supports.
      - `hold` (boolean): Flights. The supplier can hold a booking to pay later.
      - `void` (boolean): Flights. The supplier can void an issued ticket on the day of issue.
      - `flexible_dates` (boolean): Flights. The supplier supports the flexible-dates search.
      - `ancillaries` (boolean): Flights. The supplier sells extras such as seats and bags.
    - `voidDeadline` (string, deprecated): Legacy name: use `void_deadline`. 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_deadline` (string): 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.
- `meta` (object): Facts about the answer.
  - `environment` (string): 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`.
  - `permissionRequired` (string, deprecated): Legacy name: use `permission_required`. `read`: the permission the endpoint needs. The older name of `permission_required`: same value, use `permission_required`.
  - `permission_required` (string): `read`: the permission the endpoint needs. The snake_case twin of `permissionRequired`, with the same value: use this name.

```json
{
  "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"
  }
}
```

## Errors

| Status | Code | Example message |
| --- | --- | --- |


See [Errors](https://fx-port.com/docs/errors.md) for every code and how to react.

## Related guides

- [Suppliers](https://fx-port.com/docs/suppliers.md)