---
title: "List inventory items with details"
method: GET
path: "/inventory/items/with-details"
tags: ["Inventory"]
---

# List inventory items with details

`GET /inventory/items/with-details`

## Request

- Base URL: `https://api.faireplace.com/api`
- URL: `https://api.faireplace.com/api/inventory/items/with-details`
- Auth: HTTP bearer

Retrieves all inventory items with their relationship details (rooms, categories, types, condition history).

## Response `200`

Inventory items with details retrieved successfully

- Inventory[]
  - `id` string, uuid, required: Unique identifier of the inventory item
  - `inventory_type_id` string, uuid, required: Inventory type ID
  - `name` string, required: Specific name of the item
  - `description` string, nullable: Detailed description of the item
  - `brand` string, nullable: Brand of the item
  - `model` string, nullable: Model of the item
  - `serial_number` string, nullable: Serial number
  - `quantity` integer, required: Quantity of items
  - `unit` string, required: Unit of measurement
  - `condition_status` 'EXCELLENT' | 'GOOD' | 'FAIR' | 'POOR' | 'DAMAGED' | 'NEEDS_REPAIR' | 'BROKEN' | 'MISSING', required: Condition state of an inventory item
  - `condition_notes` string, nullable: Notes on the condition of the item
  - `last_condition_check` string, date, nullable: Date of the last condition check
  - `next_condition_check` string, date, nullable: Date of the next scheduled condition check
  - `purchase_date` string, date, nullable: Purchase date
  - `purchase_price` number, nullable: Purchase price
  - `current_value` number, nullable: Estimated current value
  - `insured_value` number, nullable: Insured value
  - `insurance_policy_number` string, nullable: Insurance policy number
  - `last_maintenance_date` string, date, nullable: Date of the last maintenance
  - `next_maintenance_date` string, date, nullable: Date of the next scheduled maintenance
  - `maintenance_frequency_days` integer, nullable: Maintenance frequency in days
  - `maintenance_notes` string, nullable: Maintenance notes
  - `tags` string[]: Tags for search/filtering
  - `custom_fields` object, nullable: Custom fields per tenant
  - `notes` string, nullable: General notes
  - `created_at` string, date-time, required: Creation date
  - `updated_at` string, date-time, required: Last modification date

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `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)