---
title: "List rooms containing an inventory item"
method: GET
path: "/inventory/{inventory_id}/rooms"
tags: ["Inventory"]
---

# List rooms containing an inventory item

`GET /inventory/{inventory_id}/rooms`

## Request

- Base URL: `https://api.faireplace.com/api`
- URL: `https://api.faireplace.com/api/inventory/{inventory_id}/rooms`
- Auth: HTTP bearer

Retrieves the list of all rooms containing a specific inventory item.

## Path parameters

- `inventory_id` string, uuid, required

## Response `200`

Rooms containing the item retrieved successfully

- RoomInventory[]
  - `id` string, uuid, required: Unique identifier of the junction
  - `room_id` string, uuid, required: Room ID
  - `inventory_id` string, uuid, required: Inventory item ID
  - `quantity_in_room` integer, required: Quantity of the item in this room
  - `location_description` string, nullable: Description of the location within the room
  - `position_x` number, nullable: X position in the room (in meters)
  - `position_y` number, nullable: Y position in the room (in meters)
  - `condition_in_room` 'EXCELLENT' | 'GOOD' | 'FAIR' | 'POOR' | 'DAMAGED' | 'NEEDS_REPAIR' | 'BROKEN' | 'MISSING': Condition state of an inventory item
  - `condition_notes_in_room` string, nullable: Notes on the condition in this room
  - `placed_date` string, date, required: Date placed in the room
  - `removed_date` string, date, nullable: Date removed from the room
  - `is_active` boolean, required: Indicates whether the item is currently in this room
  - `notes` string, nullable: Notes specific to this room
  - `created_at` string, date-time, required: Creation date
  - `updated_at` string, date-time, required: Last modification date

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `500`: Internal Server Error

---

[API](https://skmtc.dev/faireplace/apis/faireplace-property-management-api.md) · [All operations](https://skmtc.dev/faireplace/apis/faireplace-property-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/faireplace/apis/faireplace-property-management-api/revisions/69de39762919?raw)