---
title: "List rooms for a location"
method: GET
path: "/v1/location/{location_id}/rooms"
tags: ["Rooms"]
---

# List rooms for a location

`GET /v1/location/{location_id}/rooms`

Returns the rooms currently available for the specified location, including overview images. Depending on your integration and property setup, this endpoint may return no results. If you expect room data for your locations and are not seeing it, contact NavigateAI.

## Path parameters

- `location_id` string, required

## Response `200`

OK

- ListRoomsResponse
  - `rooms` RoomExternalSchema[], required
    - `id` string, required
    - `name` string, required — Display name (e.g. 'Bedroom 2', 'Kitchen'). Not guaranteed to be stable over time.
    - `room_type_id` string, nullable — The type of room.
    - `room_type_name` string, nullable — Display name of the room type.
    - `reference_key` string, nullable — Your external identifier for this room.
    - `measurements` object, nullable — Physical measurements of the room; individual fields are null when unknown.
      - `area_sq_in` number, nullable — Room area in square inches.
      - `length_in` number, nullable — A horizontal dimension in inches.
      - `width_in` number, nullable — A horizontal dimension in inches.
    - `images` RoomImageExternalSchema[] — Representative overview images of the room.
      - `image_id` string, required — The [ID](/api-reference/assets/get-image) of the image.
      - `visit_id` string, nullable — The visit this image was captured during.
    - `attributes` AttributeValueExternalSchema[] — Attribute values recorded for this room. Only attributes with recorded values appear; cleared values are omitted. Replace the entire list when syncing instead of merging by `slug`.
      - `attribute_id` string, required — ID of the attribute definition. It remains the same when the recorded value changes.
      - `attribute_slug` string, required — Stable key for the attribute within your organization. Use it to match attributes; display names can change.
      - `value_type` string, required — The attribute's declared type, which fixes how `value` is encoded. Current types are `bool`, `int`, `float`, `decimal`, `string`, `dimension_2d`, and `json_object`. A `decimal` is serialized as a string to preserve precision. A `dimension_2d` is a `[length, width]` pair, with the unit given in `unit`. New types may be added; handle unrecognized types.
      - `value` union, required — The recorded value, encoded according to `value_type`. A null value means the value was recorded as explicitly none, distinct from the attribute being absent from the list.
        - boolean
        - integer
        - number
        - string
        - JsonValue[]
          - unknown
        - object
      - `unit` string, nullable, required — Unit of measure for `value`, e.g. `inches` for a `dimension_2d`. Null when the value carries no unit.
      - `reasoning` string, nullable, required — Short explanation of how the value was determined. Null when none was recorded.
      - `evidence` ImageEvidenceExternalSchema[] — Images supporting the value, in ranked order, captured by the visit that last recorded it (`recorded_by_visit_id`).
        - `type` 'image'
        - `image_id` string, required — Use with the Get Image endpoint to retrieve the image file.
        - `reference_key` string, nullable
        - `visit_id` string, nullable — The visit this image was captured during.
        - `is_selected` boolean — Whether this image was explicitly selected as evidence.
        - `is_starred` boolean — Whether this image was starred as the primary evidence photo.
      - `recorded_by_visit_id` string, nullable, required — The most recent completed visit that recorded this value, including a visit that recorded it unchanged. Null when the value was recorded outside a visit.
      - `recorded_at` string, date-time, nullable, required — When the value was last recorded: the recording visit's completion time, or the time of the write for a value recorded outside a visit.

---

[API](https://skmtc.net/navigateai/apis/navigateai-api.md) · [All operations](https://skmtc.net/navigateai/apis/navigateai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/navigateai/navigateai-api/revisions/5fb236d03a88/schema)