Condition Reports

Track the condition of inventory-tracked rental items at pickup and return. Condition reports help document pre-existing damage, catch new damage on return, and automatically route damaged items to the workshop.

Key Concepts

• Per-item tracking -- condition reports are logged per individual inventory item, not per booking or product
• Dual-point inspection -- reports can be created at both pickup (documenting pre-existing condition) and return (catching new damage)
• Photo documentation -- up to 5 photos per report, required for Poor/Damaged ratings
• Workshop integration -- items returned with "Damaged" condition are automatically sent to workshop
• Condition ratings -- Excellent, Good, Fair, Poor, Damaged

Condition Ratings

Rating	Description
excellent	Item is in perfect condition
good	Minor wear, fully functional
fair	Noticeable wear but functional
poor	Significant wear, may need attention
damaged	Item is damaged and needs repair

note

When an item is returned with damaged condition, it is automatically sent to the workshop with reason returned_damaged and removed from available inventory until the workshop job is completed.

Endpoints

Method	Endpoint	Description
GET	/v1/bookings/{id}/condition-reports	List condition reports for a booking
GET	/v1/condition-reports/{id}	Get a single condition report
GET	/v1/inventory/{id}/condition-history	Get condition history for an inventory item
POST	/v1/condition-reports/{id}/photos	Upload photos to a condition report
POST	/v1/condition-reports/{id}/send-damage-charge	Send a Stripe payment link for recorded damage

Condition reports are also created as part of the item pickup and return endpoints:

Method	Endpoint	Description
POST	/v1/bookings/{id}/items/pickup	Pickup items with optional condition reports
POST	/v1/bookings/{id}/items/return	Return items with optional condition reports (accepts estimated_charge_cents)

Authentication

All condition report endpoints require a valid API key with the appropriate scope:

• Read operations: bookings:read scope
• Write operations: bookings:write scope; bookings.fulfillment permission for damage charges
• Inventory history: products:read scope

Related Resources

• Bookings -- condition reports are tied to bookings
• Inventory -- reports track condition per inventory item
• Workshop -- damaged items are auto-sent to workshop