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

id · string · required

The UUID of the transportation mode to retrieve.

Response

200 OK

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

Error Responses

400 Bad Request

{
  "error": "Invalid ID format"
}

404 Not Found

{
  "message": "Transportation mode not found"
}

500 Internal Server Error

{
  "error": "Failed to retrieve transportation mode"
}

Response Fields

id · string · required

UUID v7 identifier for the transportation mode.

code · string · required

Unique code identifier (e.g., “flight”, “train”, “bus”).

name · string · required

Human-readable name of the transportation mode.

description · string

Optional description of the transportation mode.

displayOrder · number

Order for display purposes (lower numbers appear first).

isActive · boolean · required

Whether the transportation mode is currently active.

createdAt · string · required

ISO 8601 timestamp of when the record was created.

updatedAt · string · required

ISO 8601 timestamp of when the record was last updated.

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