Reports & Ops

Inspection Report

Field inspection — checklist with inspector-assigned results, site photos, and recommended actions.

The contract

Fields your API call provides. Amounts and totals are always computed by the caller — templates only format.

site.name	string	required
site.address	string	required
photos[].image	string	required
photos[].caption	string	required
summary	string	required
checklist[].area	string	required
checklist[].result	string	required
checklist[].finding	string	required
inspector.name	string	required
inspector.credentials	string	required
report_number	string	required
inspection_date	string	required
recommendations[].text	string	required

MCP-ready: forks of this template will expose generate_inspection_report when the MCP server ships.

Generate it (after you fork & publish)

curl -X POST https://your-paperbrain-host/api/generate/gen_<your-id> \
  -H "Content-Type: application/json" \
  -d '{
    "site": {
      "name": "Riverside Warehouse — Building B",
      "address": "440 Mill Road, Hartford, CT 06114"
    },
    "photos": [
      {
        "image": "data:image/png;base64,iVBORw0KGg… (image)",
        "caption": "North parapet — membrane wear and ponding area"
      },
      {
        "image": "data:image/png;base64,iVBORw0KGg… (image)",
        "caption": "East foundation wall — stable hairline crack, monitored since 2024"
      }
    ],
    "summary": "Building B is in serviceable condition overall. The roof membrane shows wear at the north parapet and should be re-sealed before winter; foundation and electrical systems passed without findings.",
    "checklist": [
      {
        "area": "Roof membrane",
        "result": "MONITOR",
        "finding": "Wear and minor ponding at north parapet; re-seal recommended within 6 months"
      },
      {
        "area": "Foundation",
        "result": "PASS",
        "finding": "No new cracking since 2024 survey"
      },
      {
        "area": "Electrical panel",
        "result": "PASS",
        "finding": "Panel labeled, breakers within load spec"
      },
      {
        "area": "Fire suppression",
        "result": "PASS",
        "finding": "Inspection tags current; heads unobstructed"
      }
    ],
    "inspector": {
      "name": "Carlos Vega",
      "credentials": "Licensed inspector, CT #IN-40221"
    },
    "report_number": "IR-2026-118",
    "inspection_date": "2026-06-05",
    "recommendations": [
      {
        "text": "Re-seal north parapet membrane before November (est. $4-6k)"
      },
      {
        "text": "Re-photograph east foundation crack at next quarterly visit"
      }
    ]
  }'

gen_<your-id>is your generator's id once you fork and publish. The body shown is this template's sample data — the exact shape the contract validates.