> ## 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.

# Get Transportation Mode

> Retrieve a specific transportation mode by its ID.

## Method

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

## Description

Returns a single transportation mode record by its UUID. This endpoint is useful when you need the full details of a specific transportation mode after obtaining its ID from the list endpoint.

## Headers

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

## Path Parameters

<ParamField path="id" type="string" required>
  The UUID of the transportation mode to retrieve.
</ParamField>

## Response

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "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"
  }
  ```
</ResponseExample>

## Error Responses

<ResponseExample>
  ```json 400 Bad Request theme={null}
  {
    "error": "Invalid ID format"
  }
  ```
</ResponseExample>

<ResponseExample>
  ```json 404 Not Found theme={null}
  {
    "message": "Transportation mode not found"
  }
  ```
</ResponseExample>

<ResponseExample>
  ```json 500 Internal Server Error theme={null}
  {
    "error": "Failed to retrieve transportation mode"
  }
  ```
</ResponseExample>

## Response Fields

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

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

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

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

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

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

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

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

## Notes

* This endpoint returns both active and inactive transportation modes (unlike the list endpoint)
* The ID must be a valid UUID format
* If the transportation mode does not exist, a 404 error is returned