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

# List Transportation Modes

> Retrieve all active transportation modes used across the platform.

## Method

`GET` `/v1/ref/transportation-modes`

## Description

Returns the complete list of active transportation modes available in the platform. This includes modes like flight, train, bus, car, ferry, and others used for product configuration and booking workflows.

## Headers

This endpoint is **public** and does not require authentication.

## Query Parameters

No query parameters are required. The endpoint returns all active transportation modes sorted by `displayOrder` and then by `name`.

## Response

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "items": [
      {
        "id": "01234567-89ab-cdef-0123-456789abcdef",
        "code": "flight",
        "name": "Flight",
        "description": "Air travel",
        "displayOrder": 1,
        "isActive": true,
        "createdAt": "2024-01-01T00:00:00.000Z",
        "updatedAt": "2024-01-01T00:00:00.000Z"
      },
      {
        "id": "01234567-89ab-cdef-0123-456789abcdef",
        "code": "train",
        "name": "Train",
        "description": "Rail travel",
        "displayOrder": 2,
        "isActive": true,
        "createdAt": "2024-01-01T00:00:00.000Z",
        "updatedAt": "2024-01-01T00:00:00.000Z"
      }
    ]
  }
  ```
</ResponseExample>

## Response Fields

<ResponseField name="items" type="array" required>
  Array of transportation mode objects.
</ResponseField>

<ResponseField name="items[].id" type="string" required>
  UUID v7 identifier for the transportation mode.
</ResponseField>

<ResponseField name="items[].code" type="string" required>
  Unique code identifier (e.g., "flight", "train", "bus").
</ResponseField>

<ResponseField name="items[].name" type="string" required>
  Human-readable name of the transportation mode.
</ResponseField>

<ResponseField name="items[].description" type="string">
  Optional description of the transportation mode.
</ResponseField>

<ResponseField name="items[].displayOrder" type="number">
  Order for display purposes (lower numbers appear first).
</ResponseField>

<ResponseField name="items[].isActive" type="boolean" required>
  Whether the transportation mode is currently active.
</ResponseField>

<ResponseField name="items[].createdAt" type="string" required>
  ISO 8601 timestamp of when the record was created.
</ResponseField>

<ResponseField name="items[].updatedAt" type="string" required>
  ISO 8601 timestamp of when the record was last updated.
</ResponseField>

## Notes

* Only active transportation modes (`isActive: true`) are returned
* Results are sorted by `displayOrder` (ascending), then by `name` (ascending)
* Inactive or soft-deleted modes are excluded from this endpoint