> ## 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 Room Categories

> Retrieve all active room categories used for hotel and accommodation products.

## Method

`GET` `/v1/ref/room-categories`

## Description

Returns the complete list of active room categories available in the platform. These categories are used when configuring hotel and accommodation products to specify room types like Standard, Deluxe, Suite, etc.

## Headers

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

## Query Parameters

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

## Response

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "items": [
      {
        "id": "01234567-89ab-cdef-0123-456789abcdef",
        "code": "standard",
        "name": "Standard Room",
        "description": "Standard accommodation room",
        "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": "deluxe",
        "name": "Deluxe Room",
        "description": "Upgraded room with additional amenities",
        "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 room category objects.
</ResponseField>

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

<ResponseField name="items[].code" type="string" required>
  Unique code identifier (e.g., "standard", "deluxe", "suite").
</ResponseField>

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

<ResponseField name="items[].description" type="string">
  Optional description of the room category.
</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 room category 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 room categories (`isActive: true`) are returned
* Results are sorted by `displayOrder` (ascending), then by `name` (ascending)
* Inactive or soft-deleted categories are excluded from this endpoint