> ## Documentation Index
> Fetch the complete documentation index at: https://developers.ttool.travel/llms.txt
> Use this file to discover all available pages before exploring further.

# List fare brands

> List the airline's fare families for an offer.

Only call this when `offer.hasFareBrands` is `true`. See [Fare families](https://developers.ttool.travel/guides/fare-families.md).

## Body

**requestId** `string (uuid)` *required*

`requestId` from search.

**proposalId** `string (uuid)` *required*

The offer's `offerId`.

## Response

**successful** `boolean`

**isCombination** `boolean`

`true` when outbound and return brands must be chosen together. There's then one key for the whole trip, in `leavingFareOptions`.

**leavingFareOptions** `FareBrand[]`

**properties**

**title** `string`

For example `Value`.

**code** `string`

The **brand key**. Pass it to change-options as `fareBrandCode`. Its format is airline-specific (a name, a number, a token), so treat it as opaque.

**price** `number`

Total price of the offer with this brand.

**description** `string`

**fareOptions** `string[]`

Short feature lines for display.

**services** `object[]`

`title`, `description`, `inclusionType`: `0` not available, `1` included, `2` for a fee.

**returningFareOptions** `FareBrand[]`

Return-leg brands for a packed round trip priced per leg.

## Errors

| HTTP | `errorCode` | Action |
| - | - | - |
| 404 | `FARE_BRANDS_NOT_AVAILABLE` | No fare families for this offer. Use the base fare. |
| 502 | `FARE_BRANDS_SERVICE_UNAVAILABLE` | Retry with back-off. |

```bash cURL theme={null}
curl -X POST "https://api.staging.ttool.travel/hub/api/v1/flights/fare-brands" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "requestId": "3f1a1c9e-7b2d-4c7e-9a1f-2b3c4d5e6f70", "proposalId": "8d0e3b6a-2f41-4b8e-b1c9-5d6e7f8a9b0c" }'
```

```json 200 theme={null}
{
  "successful": true,
  "isCombination": false,
  "leavingFareOptions": [
    {
      "title": "Value",
      "code": "VALUE",
      "price": 436.00,
      "description": "Checked bag included",
      "fareOptions": ["1 x 23kg checked bag", "Seat selection"],
      "services": [
        { "title": "Checked baggage", "description": "23 kg", "inclusionType": 1 },
        { "title": "Refund", "description": "With fee", "inclusionType": 2 }
      ]
    }
  ],
  "returningFareOptions": []
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.