Condition Reports on Pickup/Return

Condition reports can be submitted alongside item pickup and return requests. This allows you to document item condition as part of the fulfillment flow in a single API call.

Adding Conditions to Pickup

POST /v1/bookings/{id}/items/pickup

Request Body

Field	Type	Required	Description
item_ids	string[]	No	Item IDs to pick up. Omit for all items.
condition_reports	object	No	Condition data keyed by inventory log ID
condition_reports.{id}.condition	string	Yes*	Rating: excellent, good, fair, poor, damaged
condition_reports.{id}.notes	string	No	Condition notes (max 2000 chars)

*Required if condition_reports is provided for that item.

Example

curl -X POST "https://app.equipdash.com/api/v1/bookings/123/items/pickup" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "item_ids": ["456"],
    "condition_reports": {
      "456": {
        "condition": "good",
        "notes": "Minor surface wear on handlebars"
      }
    }
  }'

Adding Conditions to Return

POST /v1/bookings/{id}/items/return

Same request format as pickup. When condition is damaged, the item is automatically sent to the workshop.

Example

curl -X POST "https://app.equipdash.com/api/v1/bookings/123/items/return" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "item_ids": ["456"],
    "condition_reports": {
      "456": {
        "condition": "damaged",
        "notes": "Deep scratch on frame, chain broken"
      }
    }
  }'

Workshop Auto-Send

When an item is returned with damaged condition:

1. The item is marked as returned
2. A condition report is created
3. The item is automatically sent to the workshop with reason returned_damaged
4. The item is removed from available inventory until the workshop job is completed

Notes

• Condition reports are optional on both pickup and return
• You can submit conditions for some items and not others
• Photos cannot be uploaded inline -- use the Upload Photos endpoint after creating the report
• Condition reports only apply to inventory-tracked items (not group-tracked products)
• The supplier setting "Require condition report on return" only applies to the web UI, not the API