Tektolo

experimentalv1.0.0 · strict determinism for the rules

Property turnover estimate

Turn move-out inspection findings into a priced, vendor-ready make-ready scope.

Operations

REST
https://tektolo.com/v1/
MCP
https://tektolo.com/mcp (streamable HTTP, no auth)
quick_estimatekind: deterministic, limits: 30/min · 5/day, price per call: Free tier

Quick turnover estimate (start here). The easiest way to estimate a US rental turnover: a ZIP, bedrooms, bathrooms and a list of plain-English issues in, a priced make-ready estimate out (same engine and result as property_turnover_scope, short summary by default).

Use it when: Start here when the user describes a move-out or turnover in words ("carpet stained in both bedrooms, oven filthy") and wants a cost estimate or what to tell vendors. Use property_turnover_scope instead for rate cards, owner decisions, measured quantities or per-finding control.

Not for: Diagnosing hazards (they come back as refer-outs to a licensed professional); legal advice on deposits; remodel bids; properties outside the US.

  • If the ZIP is missing or not exactly 5 digits, ask the user; never guess or pad it.
  • Relay refer_outs first, then the totals; say the numbers are estimates, not quotes.
  • When review.status is draft, show the user what was read (reading.findings) before you quote a number, and ask them to confirm or correct it. For a verified answer, send the confirmed findings to property_turnover_scope with confirmed true on each. A review.note says what was not read and why; with the AI reader unavailable only exact item names are priced.
  • From photos, list only what is visible, with its room ("stained carpet in bedroom 2"). Hedge doubtful ones ("possible water stain?") and ask the user about what photos cannot show: working appliances, odors, pests, sizes. Never state that a tenant caused damage because of a photo.
REST
POST /v1/property-turnover/quick_estimate
MCP tool
property_turnover_quick_estimate
Schemas
input · output
Limits
30/min · 5/day
Price per call
Free tier
Example request (curl)
curl -sS 'https://tektolo.com/v1/property-turnover/quick_estimate' \
  -H 'content-type: application/json' \
  -d '{
  "zip": "28202",
  "bedrooms": 1,
  "bathrooms": "1",
  "sq_ft": 700,
  "year_built": 2008,
  "issues": [
    "BR - tv mount holes in wall + couple nail holes",
    "LR carpet pet urine stains by the couch, smells",
    "burn mark on kitchen counter",
    "oven filthy, fridge gross",
    "2 blinds busted in LR",
    "towel bar ripped off in bath",
    "only 1 of 2 keys returned",
    "scuffs in hallway"
  ]
}'
Example response

Long lists are cut to their first items here.

{
  "run": {
    "id": "run_95f3997faa424a1496ebe3c4e8b19b87",
    "capability": "property-turnover",
    "operation": "quick_estimate",
    "contract_version": "1.0.0",
    "engine_version": "0.7.0",
    "ruleset_version": "pt-2026.11.22",
    "ruleset_hash": "sha256:18529c24a7667efdcc67250c3dac3fe7b956c1c4c6860e56bba0cef2359c054a",
    "received_at": "2026-11-19T23:51:52.121492Z",
    "duration_ms": 119
  },
  "client_refs": {},
  "input_hash": "sha256:ff45830be0a4e2856fded44ed3b39d2d0d3e8b7c0786aeef7f1641b115d75f35",
  "request_hash": "sha256:29d96d009b52ce10acabd5dbc9faae5a173628d86bb7b0400a313070cf059a1d",
  "result_hash": "sha256:74a838e479791d22d95334746eea9fab3cee59bd2de985ec5fd5ac04191d4505",
  "result": {
    "summary": "Estimate, not a quote. 19 lines across 5 trades; expected total $634.40 (range $353.15 to $1,267.97), must-fix $224.82. Pricing: Charlotte-Concord-Gastonia, NC-SC (ZIP 28202). 9 finding(s) could not be matched and need manual quotes.",
    "disclaimer": "Estimate ranges for planning, not quotes. Actual prices depend on vendors, market and conditions found on site. Responsibility hints are not legal determinations; security deposit rules vary by state. Items marked refer-out need a licensed ...",
    "warnings": [],
    "totals": {
      "note": "must, should and could are work lines only. visit_charges (minimum call-out and trip fees, once per trade) are added on top: subtotal = must + should + could + visit_charges; total = subtotal + tax. allowances and to_confirm (uncertain item...",
      "must": {
        "low": "146.44",
        "expected": "224.82",
        "high": "360.66"
      },
      "should": {
        "low": "163.71",
        "expected": "278.78",
        "high": "512.51"
      },
      "could": {
        "low": "43.00",
        "expected": "87.00",
        "high": "176.00"
      },
      "visit_charges": {
        "low": "0.00",
        "expected": "43.80",
        "high": "218.80"
      },
      "subtotal": {
        "low": "353.15",
        "expected": "634.40",
        "high": "1267.97"
      },
      "tax": {
        "low": "0.00",
        "expected": "0.00",
        "high": "0.00"
      },
      "total": {
        "low": "353.15",
        "expected": "634.40",
        "high": "1267.97"
      },
      "approved": null,
      "to_confirm": {
        "low": "0.00",
        "expected": "0.00",
        "high": "0.00"
      },
      "allowances": {
        "low": "0.00",
        "expected": "0.00",
        "high": "0.00"
      }
    },
    "refer_outs": [],
    "trade_scopes": [
      {
        "trade": "pest_control",
        "vendor": null,
        "phase": "trash_out",
        "line_ids": [],
        "lines_cost": {
          "low": "43.00",
          "expected": "87.00",
          "high": "176.00"
        },
        "visit_charges": {
          "low": "0.00",
          "expected": "13.00",
          "high": "88.00"
        },
        "total": {
          "low": "43.00",
          "expected": "100.00",
          "high": "264.00"
        }
      },
      {
        "trade": "handyman",
        "vendor": null,
        "phase": "repairs",
        "line_ids": [
          "general.manual_quote@u1",
          "general.manual_quote@u2",
          "... 7 more"
        ],
        "lines_cost": {
          "low": "59.86",
          "expected": "114.58",
          "high": "230.27"
        },
        "visit_charges": {
          "low": "0.00",
          "expected": "0.00",
          "high": "0.00"
        },
        "total": {
          "low": "59.86",
          "expected": "114.58",
          "high": "230.27"
        }
      },
      "... 3 more"
    ],
    "lines": [
      {
        "line_id": "general.manual_quote@u1",
        "task_id": "general.manual_quote",
        "name": "Tv mount holes in wall",
        "trade": "handyman",
        "phase": "repairs",
        "priority": "should",
        "location": "Bedroom",
        "finding_ids": [
          "u1"
        ],
        "quantity": "1",
        "uom": "each",
        "quantity_source": "fixed",
        "price_basis": "placeholder",
        "unit_price": {
          "low": "0.00",
          "expected": "0.00",
          "high": "0.00"
        },
        "cost": {
          "low": "0.00",
          "expected": "0.00",
          "high": "0.00"
        },
        "confidence": "assumed",
        "responsibility_hint": "undetermined",
        "responsibility_by_finding": {},
        "allowance": null,
        "refer_out": null,
        "decision": null,
        "vendor_note": "Not a standard item; inspect on site and price manually. Closest standard items: Many nail holes or…",
        "rule_ids": [],
        "to_confirm": false,
        "needs_review": false
      },
      {
        "line_id": "general.manual_quote@u2",
        "task_id": "general.manual_quote",
        "name": "Couple nail holes",
        "trade": "handyman",
        "phase": "repairs",
        "priority": "should",
        "location": "Bedroom",
        "finding_ids": [
          "u2"
        ],
        "quantity": "1",
        "uom": "each",
        "quantity_source": "fixed",
        "price_basis": "placeholder",
        "unit_price": {
          "low": "0.00",
          "expected": "0.00",
          "high": "0.00"
        },
        "cost": {
          "low": "0.00",
          "expected": "0.00",
          "high": "0.00"
        },
        "confidence": "assumed",
        "responsibility_hint": "undetermined",
        "responsibility_by_finding": {},
        "allowance": null,
        "refer_out": null,
        "decision": null,
        "vendor_note": "Not a standard item; inspect on site and price manually. Closest standard items: Small to doorknob-…",
        "rule_ids": [],
        "to_confirm": false,
        "needs_review": false
      },
      "... 7 more"
    ],
    "lines_omitted": 10,
    "omitted_note": "10 routine turn line(s) not listed here (Pest inspection and preventive treatment; Replace HVAC filter (turn standard); Touch-up paint throughout unit (turn standard); Standard turn clean: per bathroom; Standard turn clean: per bedroom; Sta...",
    "findings": [
      {
        "finding_id": "u1",
        "resolution": "unmapped",
        "not_billed_reason": null,
        "code": null,
        "issue_name": null,
        "text": "tv mount holes in wall",
        "location": "Bedroom",
        "match_note": null,
        "uncertain": false,
        "extent": null,
        "suggested_codes": [
          "walls.holes_many",
          "tenant_alteration.restore",
          "... 1 more"
        ],
        "suggestions": [
          {
            "code": "walls.holes_many",
            "name": "Many nail holes or TV-mount holes (cumulative wall damage)"
          },
          {
            "code": "tenant_alteration.restore",
            "name": "Tenant alteration to remove and restore (installed or added without approval)"
          },
          "... 1 more"
        ],
        "line_ids": [
          "general.manual_quote@u1"
        ],
        "needs_review": false,
        "confidence": null,
        "model": null
      },
      {
        "finding_id": "u2",
        "resolution": "unmapped",
        "not_billed_reason": null,
        "code": null,
        "issue_name": null,
        "text": "couple nail holes",
        "location": "Bedroom",
        "match_note": null,
        "uncertain": false,
        "extent": null,
        "suggested_codes": [
          "walls.hole_medium",
          "walls.holes_many",
          "... 1 more"
        ],
        "suggestions": [
          {
            "code": "walls.hole_medium",
            "name": "Small to doorknob-size hole in wall (up to about 6 in)"
          },
          {
            "code": "walls.holes_many",
            "name": "Many nail holes or TV-mount holes (cumulative wall damage)"
          },
          "... 1 more"
        ],
        "line_ids": [
          "general.manual_quote@u2"
        ],
        "needs_review": false,
        "confidence": null,
        "model": null
      },
      "... 7 more"
    ],
    "assumptions": [
      {
        "code": "tax.none",
        "message": "No tax rate given; totals exclude sales tax.",
        "finding_ids": [],
        "line_ids": []
      }
    ],
    "unknowns": [
      {
        "code": "finding.manual_quote",
        "message": "Listed as a manual quote (general.manual_quote): get a quote on site; it counts as zero in the totals.",
        "finding_ids": [
          "u1",
          "u2",
          "... 7 more"
        ],
        "line_ids": []
      },
      {
        "code": "floor.carpet_unknown",
        "message": "Floor coverings not given and no carpet findings: whole-unit carpet cleaning is not included. Pass property.floor_coverings.",
        "finding_ids": [],
        "line_ids": []
      },
      "... 1 more"
    ],
    "rate_card_applied": [],
    "rate_card_ignored": [],
    "detail": "summary",
    "region": {
      "zip3": "282",
      "basis": "metro",
      "cbsa": "16740",
      "cbsa_name": "Charlotte-Concord-Gastonia, NC-SC",
      "vintage": "OEWS May 2025"
    },
    "profile": "standard",
    "price_tier": "pm_vendor",
    "provenance": {
      "ruleset_id": "property-turnover",
      "ruleset_version": "pt-2026.11.22",
      "ruleset_hash": "sha256:18529c24a7667efdcc67250c3dac3fe7b956c1c4c6860e56bba0cef2359c054a",
      "sources": [],
      "rules_as_of": null
    }
  },
  "review": {
    "status": "verified",
    "ai_read": 0,
    "reading_id": "rd_a2cd2307d94ced5e777ffaee",
    "note": "The AI reader is switched off, so this text was read without AI: only lines that are exactly a standard item were read, and nothing was billed from a guess. 9 lines were not read (lines 1 to 8); they are listed as manual quotes and nothing ..."
  },
  "reading": {
    "id": "rd_a2cd2307d94ced5e777ffaee",
    "kind": "notes",
    "model": null,
    "prompt_version": null,
    "counts": {
      "total": 9,
      "ai": 0,
      "parser": 0,
      "unmatched": 9
    },
    "findings": [
      {
        "id": "u1",
        "code": "general.manual_quote",
        "notes": "Not read by the AI reader. The whole line: BR - tv mount holes in wall + couple nail holes",
        "rooms": {
          "area": "bedroom",
          "labels": [
            "Bedroom"
          ],
          "count": 1
        },
        "source_text": "tv mount holes in wall"
      },
      {
        "id": "u2",
        "code": "general.manual_quote",
        "notes": "Not read by the AI reader. Part of the line: BR - tv mount holes in wall + couple nail holes",
        "rooms": {
          "area": "bedroom",
          "labels": [
            "Bedroom"
          ],
          "count": 1
        },
        "source_text": "couple nail holes"
      },
      "... 7 more"
    ],
    "notes": []
  },
  "deprecation": null
}
Schemas

Input

{
  "$defs": {
    "PriceTier": {
      "description": "Purchasing channel. Library prices are pm_vendor (a PM buying turns from a local vendor).",
      "enum": [
        "bulk_contract",
        "pm_vendor",
        "retail_one_off"
      ],
      "title": "PriceTier",
      "type": "string"
    },
    "Profile": {
      "enum": [
        "minimum",
        "standard",
        "premium"
      ],
      "title": "Profile",
      "type": "string"
    },
    "UnitType": {
      "enum": [
        "apartment",
        "single_family",
        "townhome",
        "condo",
        "duplex",
        "manufactured"
      ],
      "title": "UnitType",
      "type": "string"
    }
  },
  "additionalProperties": false,
  "description": "Flat, primitive-only input: the easiest way to get an estimate.",
  "properties": {
    "client_refs": {
      "anyOf": [
        {
          "additionalProperties": {
            "type": "string"
          },
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Your own reference ids (e.g. unit_id, job_id). Echoed back, never used.",
      "title": "Client Refs"
    },
    "zip": {
      "description": "The user's 5-digit US ZIP code. If it is missing or not exactly 5 digits, ask the user; never guess, pad or correct it.",
      "pattern": "^\\d{5}$",
      "title": "Zip",
      "type": "string"
    },
    "bedrooms": {
      "description": "0 for a studio.",
      "maximum": 12,
      "minimum": 0,
      "title": "Bedrooms",
      "type": "integer"
    },
    "bathrooms": {
      "anyOf": [
        {
          "maximum": 12.0,
          "minimum": 0.0,
          "multipleOf": 0.5,
          "type": "number"
        },
        {
          "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$",
          "type": "string"
        }
      ],
      "description": "Half baths count as 0.5.",
      "title": "Bathrooms"
    },
    "issues": {
      "description": "What was found in plain English, e.g. ['stained carpet in both bedrooms', 'nail holes everywhere', 'oven is filthy']. Read like pasted notes: an entry may hold several conditions ('carpet stained, nail holes'; one finding each); a room before or after the condition sets the location ('Bedroom 2 carpet torn', 'mold in bathroom'); a written count sets the quantity ('3 blinds broken'); an entry saying there is no work ('no mold', 'leak fixed by tenant') is reported as not billed. All the issues together may hold up to 12,000 characters; send longer notes in more than one request.",
      "items": {
        "type": "string"
      },
      "maxItems": 100,
      "title": "Issues",
      "type": "array"
    },
    "unit_type": {
      "$ref": "#/$defs/UnitType",
      "default": "apartment",
      "description": "Single-family homes and townhomes get house-sized defaults (floor area, locks)."
    },
    "sq_ft": {
      "anyOf": [
        {
          "maximum": 20000,
          "minimum": 150,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Interior sq ft.",
      "title": "Sq Ft"
    },
    "year_built": {
      "anyOf": [
        {
          "maximum": 2100,
          "minimum": 1700,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Drives lead-paint (pre-1978) handling.",
      "title": "Year Built"
    },
    "carpet": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Is there wall-to-wall carpet?",
      "title": "Carpet"
    },
    "pets": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Did pets live in the unit? true adds an optional flea treatment.",
      "title": "Pets"
    },
    "walk_date": {
      "anyOf": [
        {
          "format": "date",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "The walk-through date; dated or aged items are judged against it. Omit if unknown.",
      "title": "Walk Date"
    },
    "profile": {
      "$ref": "#/$defs/Profile",
      "default": "standard",
      "description": "minimum (rent-ready basics) | standard | premium (higher finish)."
    },
    "price_tier": {
      "$ref": "#/$defs/PriceTier",
      "default": "pm_vendor",
      "description": "bulk_contract (portfolio contract prices) | pm_vendor (default: a property manager buying turns from local vendors) | retail_one_off (an owner hiring one contractor)."
    },
    "detail": {
      "default": "summary",
      "description": "summary (default, small) or full (every line).",
      "enum": [
        "summary",
        "full"
      ],
      "title": "Detail",
      "type": "string"
    },
    "retain": {
      "default": true,
      "description": "Optional (contract 0.5.1). false: keep none of this request's text, so the AI reader's answer for the issues is not stored either. By default the text is kept with contact details and access codes removed, to improve matching; the estimate is the same either way.",
      "title": "Retain",
      "type": "boolean"
    }
  },
  "required": [
    "zip",
    "bedrooms",
    "bathrooms"
  ],
  "title": "QuickEstimateRequest",
  "type": "object"
}

Output

{
  "$defs": {
    "CostRange": {
      "description": "A low / expected / high estimate. Invariant: low <= expected <= high.",
      "properties": {
        "low": {
          "title": "Low",
          "type": "string"
        },
        "expected": {
          "title": "Expected",
          "type": "string"
        },
        "high": {
          "title": "High",
          "type": "string"
        }
      },
      "required": [
        "low",
        "expected",
        "high"
      ],
      "title": "CostRange",
      "type": "object"
    },
    "Extent": {
      "enum": [
        "spot",
        "partial",
        "full"
      ],
      "title": "Extent",
      "type": "string"
    },
    "FindingResolution": {
      "properties": {
        "finding_id": {
          "title": "Finding Id",
          "type": "string"
        },
        "resolution": {
          "description": "exact: a taxonomy code was given. alias: the description matched an alias. ai: an AI reader chose the code from free text (see confidence, model; needs_review). unmapped: nothing matched (a manual-quote line). not_billed: the description says there is no work ('no mold', 'faucet not leaking', 'fixed by tenant'), or names no condition at all (a heading, a date, a signature, a year built); no lines, no refer-out; the issue it names is in suggestions and the reason in not_billed_reason.",
          "enum": [
            "exact",
            "alias",
            "ai",
            "unmapped",
            "not_billed"
          ],
          "title": "Resolution",
          "type": "string"
        },
        "not_billed_reason": {
          "anyOf": [
            {
              "enum": [
                "none",
                "ok",
                "done",
                "no_condition"
              ],
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "resolution 'not_billed' only. none: says there is none ('no mold', 'mold: none'); ok: says it works or is fine; done: says it was already fixed or done; no_condition: names no condition, only a heading, small talk, a signature or the year built ('Unit 4B - Move-out inspection', 'Built 1972'), see match_note (contract 0.13.0, additive).",
          "title": "Not Billed Reason"
        },
        "code": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Code"
        },
        "issue_name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Readable name of `code`.",
          "title": "Issue Name"
        },
        "text": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "The finding as given (description, else code), for tracing.",
          "title": "Text"
        },
        "location": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Where, as shown on the lines.",
          "title": "Location"
        },
        "match_note": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Set when the match left a fixture word unexplained: check this finding.",
          "title": "Match Note"
        },
        "uncertain": {
          "default": false,
          "description": "The description hedges ('mold?', 'maybe', 'possible'). Refer-outs from uncertain findings are check-first: they add a warning instead of holding phases.",
          "title": "Uncertain",
          "type": "boolean"
        },
        "extent": {
          "anyOf": [
            {
              "$ref": "#/$defs/Extent"
            },
            {
              "type": "null"
            }
          ]
        },
        "suggested_codes": {
          "default": [],
          "items": {
            "type": "string"
          },
          "title": "Suggested Codes",
          "type": "array"
        },
        "suggestions": {
          "description": "Suggested codes with readable names, best first.",
          "items": {
            "$ref": "#/$defs/Suggestion"
          },
          "title": "Suggestions",
          "type": "array"
        },
        "line_ids": {
          "default": [],
          "items": {
            "type": "string"
          },
          "title": "Line Ids",
          "type": "array"
        },
        "needs_review": {
          "default": false,
          "description": "True when software read this finding from free text (resolution 'ai'): check it.",
          "title": "Needs Review",
          "type": "boolean"
        },
        "confidence": {
          "anyOf": [
            {
              "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$",
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "resolution 'ai' only: the AI reader's confidence, 0 to 1.",
          "title": "Confidence"
        },
        "model": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "resolution 'ai' only: the model used.",
          "title": "Model"
        },
        "confirmed": {
          "default": false,
          "description": "Read by AI and confirmed by the person (sent with confirmed: true).",
          "title": "Confirmed",
          "type": "boolean"
        }
      },
      "required": [
        "finding_id",
        "resolution",
        "code",
        "extent"
      ],
      "title": "FindingResolution",
      "type": "object"
    },
    "Note": {
      "properties": {
        "code": {
          "title": "Code",
          "type": "string"
        },
        "message": {
          "title": "Message",
          "type": "string"
        },
        "finding_ids": {
          "default": [],
          "items": {
            "type": "string"
          },
          "title": "Finding Ids",
          "type": "array"
        },
        "line_ids": {
          "default": [],
          "items": {
            "type": "string"
          },
          "title": "Line Ids",
          "type": "array"
        }
      },
      "required": [
        "code",
        "message"
      ],
      "title": "Note",
      "type": "object"
    },
    "Phase": {
      "description": "Make-ready order. Values sort in sequence order via PHASE_ORDER.",
      "enum": [
        "assess",
        "trash_out",
        "repairs",
        "paint",
        "flooring",
        "appliances",
        "cleaning",
        "punch",
        "rekey"
      ],
      "title": "Phase",
      "type": "string"
    },
    "PriceBasis": {
      "enum": [
        "rate_card",
        "unit_price",
        "labor_derived",
        "placeholder"
      ],
      "title": "PriceBasis",
      "type": "string"
    },
    "PriceTier": {
      "description": "Purchasing channel. Library prices are pm_vendor (a PM buying turns from a local vendor).",
      "enum": [
        "bulk_contract",
        "pm_vendor",
        "retail_one_off"
      ],
      "title": "PriceTier",
      "type": "string"
    },
    "Priority": {
      "enum": [
        "must",
        "should",
        "could"
      ],
      "title": "Priority",
      "type": "string"
    },
    "Profile": {
      "enum": [
        "minimum",
        "standard",
        "premium"
      ],
      "title": "Profile",
      "type": "string"
    },
    "Provenance": {
      "properties": {
        "ruleset_id": {
          "title": "Ruleset Id",
          "type": "string"
        },
        "ruleset_version": {
          "title": "Ruleset Version",
          "type": "string"
        },
        "ruleset_hash": {
          "title": "Ruleset Hash",
          "type": "string"
        },
        "sources": {
          "items": {
            "$ref": "#/$defs/SourceRef"
          },
          "title": "Sources",
          "type": "array"
        },
        "rules_as_of": {
          "anyOf": [
            {
              "format": "date",
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "The oldest reading of the sources behind the legal items in this result (refer-outs and state mandates): the rules are as of this date. None when the result states no legal rule.",
          "title": "Rules As Of"
        }
      },
      "required": [
        "ruleset_id",
        "ruleset_version",
        "ruleset_hash",
        "sources"
      ],
      "title": "Provenance",
      "type": "object"
    },
    "RateCardUse": {
      "properties": {
        "entry": {
          "description": "0-based index into the request's rate_card.",
          "title": "Entry",
          "type": "integer"
        },
        "target": {
          "description": "The entry's task_id or trade.",
          "title": "Target",
          "type": "string"
        },
        "lines": {
          "default": [],
          "items": {
            "type": "string"
          },
          "title": "Lines",
          "type": "array"
        },
        "note": {
          "title": "Note",
          "type": "string"
        }
      },
      "required": [
        "entry",
        "target",
        "note"
      ],
      "title": "RateCardUse",
      "type": "object"
    },
    "ReferOutNote": {
      "properties": {
        "id": {
          "title": "Id",
          "type": "string"
        },
        "name": {
          "title": "Name",
          "type": "string"
        },
        "professional": {
          "title": "Professional",
          "type": "string"
        },
        "reason": {
          "title": "Reason",
          "type": "string"
        },
        "kind": {
          "enum": [
            "assessment",
            "compliance"
          ],
          "title": "Kind",
          "type": "string"
        },
        "finding_ids": {
          "items": {
            "type": "string"
          },
          "title": "Finding Ids",
          "type": "array"
        },
        "blocks_phases": {
          "items": {
            "$ref": "#/$defs/Phase"
          },
          "title": "Blocks Phases",
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "title": "Sources",
          "type": "array"
        },
        "unconfirmed": {
          "default": false,
          "description": "No finding confirms it: every finding that raised it was hedged ('maybe', '?'), named the hazard only in its words (description, notes or location label) rather than through its issue code, or stated an older year built than the request. Check first; no phase is held until the condition is confirmed (see warnings).",
          "title": "Unconfirmed",
          "type": "boolean"
        }
      },
      "required": [
        "id",
        "name",
        "professional",
        "reason",
        "kind",
        "finding_ids",
        "blocks_phases",
        "sources"
      ],
      "title": "ReferOutNote",
      "type": "object"
    },
    "Region": {
      "properties": {
        "zip3": {
          "title": "Zip3",
          "type": "string"
        },
        "basis": {
          "enum": [
            "metro",
            "nonmetro",
            "national"
          ],
          "title": "Basis",
          "type": "string"
        },
        "cbsa": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Cbsa"
        },
        "cbsa_name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Cbsa Name"
        },
        "vintage": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Vintage"
        }
      },
      "required": [
        "zip3",
        "basis"
      ],
      "title": "Region",
      "type": "object"
    },
    "Responsibility": {
      "enum": [
        "normal_wear",
        "likely_damage",
        "elective",
        "undetermined",
        "mixed"
      ],
      "title": "Responsibility",
      "type": "string"
    },
    "ScopeLine": {
      "properties": {
        "line_id": {
          "title": "Line Id",
          "type": "string"
        },
        "task_id": {
          "title": "Task Id",
          "type": "string"
        },
        "name": {
          "title": "Name",
          "type": "string"
        },
        "trade": {
          "$ref": "#/$defs/Trade"
        },
        "phase": {
          "$ref": "#/$defs/Phase"
        },
        "priority": {
          "$ref": "#/$defs/Priority"
        },
        "location": {
          "title": "Location",
          "type": "string"
        },
        "finding_ids": {
          "items": {
            "type": "string"
          },
          "title": "Finding Ids",
          "type": "array"
        },
        "quantity": {
          "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$",
          "title": "Quantity",
          "type": "string"
        },
        "uom": {
          "$ref": "#/$defs/Uom"
        },
        "quantity_source": {
          "enum": [
            "given",
            "converted",
            "derived",
            "fixed"
          ],
          "title": "Quantity Source",
          "type": "string"
        },
        "price_basis": {
          "$ref": "#/$defs/PriceBasis"
        },
        "unit_price": {
          "$ref": "#/$defs/CostRange"
        },
        "cost": {
          "$ref": "#/$defs/CostRange"
        },
        "confidence": {
          "enum": [
            "sourced",
            "industry_typical",
            "assumed"
          ],
          "title": "Confidence",
          "type": "string"
        },
        "responsibility_hint": {
          "$ref": "#/$defs/Responsibility"
        },
        "responsibility_by_finding": {
          "additionalProperties": {
            "$ref": "#/$defs/Responsibility"
          },
          "description": "Set when the hint is 'mixed': the hint of each finding the line carries.",
          "title": "Responsibility By Finding",
          "type": "object"
        },
        "allowance": {
          "anyOf": [
            {
              "$ref": "#/$defs/CostRange"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Quote-required lines only: a non-binding budget range. NOT included in any total; summed separately in totals.allowances."
        },
        "refer_out": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Refer Out"
        },
        "decision": {
          "anyOf": [
            {
              "enum": [
                "approve",
                "decline",
                "defer"
              ],
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Decision"
        },
        "vendor_note": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Vendor Note"
        },
        "rule_ids": {
          "items": {
            "type": "string"
          },
          "title": "Rule Ids",
          "type": "array"
        },
        "to_confirm": {
          "default": false,
          "description": "Every finding behind this line is uncertain, or it is a check-first assessment from the safety net: priced, but not in must/should/could, subtotal or total (see totals.to_confirm).",
          "title": "To Confirm",
          "type": "boolean"
        },
        "needs_review": {
          "default": false,
          "description": "A finding behind this line was read by AI from free text: check it.",
          "title": "Needs Review",
          "type": "boolean"
        }
      },
      "required": [
        "line_id",
        "task_id",
        "name",
        "trade",
        "phase",
        "priority",
        "location",
        "finding_ids",
        "quantity",
        "uom",
        "quantity_source",
        "price_basis",
        "unit_price",
        "cost",
        "confidence",
        "responsibility_hint",
        "rule_ids"
      ],
      "title": "ScopeLine",
      "type": "object"
    },
    "SourceRef": {
      "properties": {
        "id": {
          "title": "Id",
          "type": "string"
        },
        "title": {
          "title": "Title",
          "type": "string"
        },
        "url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Url"
        },
        "accessed": {
          "anyOf": [
            {
              "format": "date",
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "When the source was last read.",
          "title": "Accessed"
        }
      },
      "required": [
        "id",
        "title"
      ],
      "title": "SourceRef",
      "type": "object"
    },
    "Suggestion": {
      "properties": {
        "code": {
          "title": "Code",
          "type": "string"
        },
        "name": {
          "title": "Name",
          "type": "string"
        }
      },
      "required": [
        "code",
        "name"
      ],
      "title": "Suggestion",
      "type": "object"
    },
    "Totals": {
      "properties": {
        "note": {
          "default": "must, should and could are work lines only. visit_charges (minimum call-out and trip fees, once per trade) are added on top: subtotal = must + should + could + visit_charges; total = subtotal + tax. allowances and to_confirm (uncertain items) are outside the total.",
          "description": "How the totals add up.",
          "title": "Note",
          "type": "string"
        },
        "must": {
          "$ref": "#/$defs/CostRange"
        },
        "should": {
          "$ref": "#/$defs/CostRange"
        },
        "could": {
          "$ref": "#/$defs/CostRange"
        },
        "visit_charges": {
          "$ref": "#/$defs/CostRange"
        },
        "subtotal": {
          "$ref": "#/$defs/CostRange"
        },
        "tax": {
          "$ref": "#/$defs/CostRange"
        },
        "total": {
          "$ref": "#/$defs/CostRange"
        },
        "approved": {
          "anyOf": [
            {
              "$ref": "#/$defs/CostRange"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "to_confirm": {
          "$ref": "#/$defs/CostRange",
          "description": "Lines from uncertain findings ('maybe', '?', 'possible') and safety items read from plain words (the refer-out safety net): priced, but outside every total until confirmed on site. Those lines carry to_confirm: true (contract 0.7.0)."
        },
        "allowances": {
          "$ref": "#/$defs/CostRange",
          "description": "Budget allowance for quote-required lines (refer-outs, manual quotes). Shown outside the totals: subtotal and total never include it."
        }
      },
      "required": [
        "must",
        "should",
        "could",
        "visit_charges",
        "subtotal",
        "tax",
        "total"
      ],
      "title": "Totals",
      "type": "object"
    },
    "Trade": {
      "enum": [
        "hauling",
        "handyman",
        "drywall",
        "painter",
        "flooring",
        "carpet_cleaning",
        "cleaning",
        "appliance",
        "plumber",
        "electrician",
        "hvac",
        "locksmith",
        "pest_control",
        "landscaping",
        "window_glass",
        "environmental",
        "structural"
      ],
      "title": "Trade",
      "type": "string"
    },
    "TradeScope": {
      "properties": {
        "trade": {
          "$ref": "#/$defs/Trade"
        },
        "vendor": {
          "anyOf": [
            {
              "$ref": "#/$defs/Vendor"
            },
            {
              "type": "null"
            }
          ]
        },
        "phase": {
          "$ref": "#/$defs/Phase"
        },
        "line_ids": {
          "items": {
            "type": "string"
          },
          "title": "Line Ids",
          "type": "array"
        },
        "lines_cost": {
          "$ref": "#/$defs/CostRange"
        },
        "visit_charges": {
          "$ref": "#/$defs/CostRange"
        },
        "total": {
          "$ref": "#/$defs/CostRange"
        }
      },
      "required": [
        "trade",
        "vendor",
        "phase",
        "line_ids",
        "lines_cost",
        "visit_charges",
        "total"
      ],
      "title": "TradeScope",
      "type": "object"
    },
    "Uom": {
      "enum": [
        "each",
        "sq_ft",
        "sq_ft_floor",
        "sq_yd",
        "linear_ft",
        "room",
        "unit",
        "bedroom",
        "bathroom",
        "hour",
        "cu_yd",
        "visit"
      ],
      "title": "Uom",
      "type": "string"
    },
    "Vendor": {
      "additionalProperties": false,
      "properties": {
        "name": {
          "maxLength": 120,
          "title": "Name",
          "type": "string"
        },
        "contact": {
          "anyOf": [
            {
              "maxLength": 200,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Contact"
        }
      },
      "required": [
        "name"
      ],
      "title": "Vendor",
      "type": "object"
    }
  },
  "description": "Field order puts the answer first (summary, disclaimer, totals, refer-outs, vendor\nscopes), because agents and truncating clients read from the top.",
  "properties": {
    "summary": {
      "title": "Summary",
      "type": "string"
    },
    "disclaimer": {
      "title": "Disclaimer",
      "type": "string"
    },
    "warnings": {
      "items": {
        "$ref": "#/$defs/Note"
      },
      "title": "Warnings",
      "type": "array"
    },
    "totals": {
      "$ref": "#/$defs/Totals"
    },
    "refer_outs": {
      "items": {
        "$ref": "#/$defs/ReferOutNote"
      },
      "title": "Refer Outs",
      "type": "array"
    },
    "trade_scopes": {
      "items": {
        "$ref": "#/$defs/TradeScope"
      },
      "title": "Trade Scopes",
      "type": "array"
    },
    "lines": {
      "items": {
        "$ref": "#/$defs/ScopeLine"
      },
      "title": "Lines",
      "type": "array"
    },
    "lines_omitted": {
      "description": "Lines left out in summary detail.",
      "title": "Lines Omitted",
      "type": "integer"
    },
    "omitted_note": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Summary detail: what the omitted lines are (routine turn tasks) and their cost.",
      "title": "Omitted Note"
    },
    "findings": {
      "items": {
        "$ref": "#/$defs/FindingResolution"
      },
      "title": "Findings",
      "type": "array"
    },
    "assumptions": {
      "items": {
        "$ref": "#/$defs/Note"
      },
      "title": "Assumptions",
      "type": "array"
    },
    "unknowns": {
      "items": {
        "$ref": "#/$defs/Note"
      },
      "title": "Unknowns",
      "type": "array"
    },
    "rate_card_applied": {
      "description": "Rate card entries that changed a price.",
      "items": {
        "$ref": "#/$defs/RateCardUse"
      },
      "title": "Rate Card Applied",
      "type": "array"
    },
    "rate_card_ignored": {
      "description": "Rate card entries that changed nothing, with why.",
      "items": {
        "$ref": "#/$defs/RateCardUse"
      },
      "title": "Rate Card Ignored",
      "type": "array"
    },
    "detail": {
      "enum": [
        "summary",
        "full"
      ],
      "title": "Detail",
      "type": "string"
    },
    "region": {
      "$ref": "#/$defs/Region"
    },
    "profile": {
      "$ref": "#/$defs/Profile"
    },
    "price_tier": {
      "$ref": "#/$defs/PriceTier",
      "default": "pm_vendor"
    },
    "provenance": {
      "$ref": "#/$defs/Provenance"
    }
  },
  "required": [
    "summary",
    "disclaimer",
    "warnings",
    "totals",
    "refer_outs",
    "trade_scopes",
    "lines",
    "lines_omitted",
    "findings",
    "assumptions",
    "unknowns",
    "detail",
    "region",
    "profile",
    "provenance"
  ],
  "title": "ScopeResult",
  "type": "object"
}
scopekind: deterministic, limits: 30/min · 5/day, price per call: Free tier

Scope a property turnover. Turn move-out / turnover inspection findings for a US rental unit into a priced make-ready scope: standardized tasks by trade, regional low/expected/high costs, must/should/could priorities, vendor scopes, refer-outs to licensed professionals, and every assumption stated.

Use it when: Turnover findings for a US rental unit when you need control: rooms, measured quantities, the manager's own prices (rate_card) or owner approve/decline decisions. For a plain-English estimate, property_turnover_quick_estimate is easier.

Not for: Diagnosing hazards (they come back as refer-outs to a licensed professional); legal advice on deposits; remodel bids; properties outside the US.

  • If the ZIP is missing or not exactly 5 digits, ask the user; never guess or pad it.
  • From photos, describe only what is visible, with its room; an issue code only if one clearly fits, else general.manual_quote with your words in source_text. Hedge doubtful ones ("possible", "?") and ask the user about what photos cannot show: working appliances, odors, pests, sizes. Never state that a tenant caused damage because of a photo; responsibility stays a hint from the engine. Send no faces, names or addresses. A photo of a written checklist or report is different, so transcribe it as written.
  • Send a code on every finding, from property_turnover_issue_codes (search with q, read not_when), with the original words in source_text; general.manual_quote when no code fits. One code per condition; rooms as sets with counts ({"area": "bedroom", "count": 3}); status done, ok or none from the words; only evidence (a test result) clears a hazard. An unknown code is refused with the closest codes. A finding with no code is deprecated: until the date in deprecation it is a manual quote (not priced) whose words are still scanned for safety checks; read is ignored. For free text, use property_turnover_quick_estimate.
  • To confirm an AI reading, send the findings from reading.findings (keep each one's extraction, correct any the user changes) with confirmed true on each one the user checked. The answer is then verified and still shows which findings were read by AI.
  • Give measured quantities when you have them (e.g. 120 sq_ft); otherwise typical sizes are assumed and listed in assumptions.
  • Send property.floor_coverings when you know whether there is carpet, and unit_type single_family for houses; both change the baseline scope.
  • Relay the summary, refer_outs, assumptions and unknowns to the user; costs are estimate ranges, not quotes.
  • Use detail=summary unless the user asks for every line item (summary already lists every line tied to a finding).
  • Rate card examples - {"trade": "handyman", "unit_price": 65, "uom": "hour"} or {"task_id": "carpet.clean", "unit_price": 0.2, "uom": "sq_ft"}; check rate_card_applied and rate_card_ignored before saying a rate was used.
  • For the Excel workbook or owner estimate, give the user links.web_tool_prefilled (opens the free web tool with these findings) or POST the same arguments to links.downloads; do not build a spreadsheet yourself.
REST
POST /v1/property-turnover/scope
Downloads
POST /v1/property-turnover/scope/render/{xlsx,html,csv,vendor_csv,bids_html}
MCP tool
property_turnover_scope
Schemas
input · output
Limits
30/min · 5/day; downloads 6/min
Price per call
Free tier
Example request (curl)
curl -sS 'https://tektolo.com/v1/property-turnover/scope' \
  -H 'content-type: application/json' \
  -d '{
  "property": {
    "zip": "28202",
    "unit_type": "apartment",
    "bedrooms": 1,
    "bathrooms": "1",
    "sq_ft": 700,
    "year_built": 2008
  },
  "standards": {
    "profile": "standard"
  },
  "findings": [
    {
      "id": "f1",
      "location": {
        "area": "bedroom",
        "label": "Bedroom"
      },
      "code": "walls.nail_holes",
      "extent": "partial"
    },
    {
      "id": "f2",
      "location": {
        "area": "living_room",
        "label": "Living room"
      },
      "code": "walls.scuffs",
      "extent": "spot"
    },
    {
      "id": "f3",
      "location": {
        "area": "living_room",
        "label": "Living room"
      },
      "code": "carpet.soiled",
      "extent": "partial",
      "quantity": {
        "value": 220,
        "uom": "sq_ft"
      }
    },
    {
      "id": "f4",
      "location": {
        "area": "bedroom",
        "label": "Bedroom"
      },
      "code": "carpet.soiled",
      "extent": "partial",
      "quantity": {
        "value": 140,
        "uom": "sq_ft"
      }
    },
    {
      "id": "f5",
      "location": {
        "area": "kitchen",
        "label": "Kitchen"
      },
      "code": "range.dirty"
    },
    {
      "id": "f6",
      "location": {
        "area": "kitchen",
        "label": "Kitchen"
      },
      "code": "refrigerator.dirty"
    },
    {
      "id": "f7",
      "location": {
        "area": "living_room",
        "label": "Living room"
      },
      "code": "blinds.bent_missing",
      "quantity": {
        "value": 1,
        "uom": "each"
      }
    }
  ],
  "client_refs": {
    "unit_id": "example-1bed-charlotte"
  }
}'
Example response

Long lists are cut to their first items here.

{
  "run": {
    "id": "run_d6ba6997952b416aab42683ca858693a",
    "capability": "property-turnover",
    "operation": "scope",
    "contract_version": "1.0.0",
    "engine_version": "0.7.0",
    "ruleset_version": "pt-2026.11.22",
    "ruleset_hash": "sha256:18529c24a7667efdcc67250c3dac3fe7b956c1c4c6860e56bba0cef2359c054a",
    "received_at": "2026-11-19T23:51:52.333336Z",
    "duration_ms": 5
  },
  "client_refs": {
    "unit_id": "example-1bed-charlotte"
  },
  "input_hash": "sha256:1dd293c62cfba820ac9eda293ea120bdefa6f7b3637c56ca5aab325505676ff5",
  "request_hash": "sha256:1dd293c62cfba820ac9eda293ea120bdefa6f7b3637c56ca5aab325505676ff5",
  "result_hash": "sha256:0321bfe682e8f3eee9449f1a66fb71c9f0f8fbb3577e5315463705159caa7fc2",
  "result": {
    "summary": "Estimate, not a quote. 15 lines across 6 trades; expected total $854.00 (range $489.13 to $1,727.62), must-fix $578.38. Pricing: Charlotte-Concord-Gastonia, NC-SC (ZIP 28202).",
    "disclaimer": "Estimate ranges for planning, not quotes. Actual prices depend on vendors, market and conditions found on site. Responsibility hints are not legal determinations; security deposit rules vary by state. Items marked refer-out need a licensed ...",
    "warnings": [],
    "totals": {
      "note": "must, should and could are work lines only. visit_charges (minimum call-out and trip fees, once per trade) are added on top: subtotal = must + should + could + visit_charges; total = subtotal + tax. allowances and to_confirm (uncertain item...",
      "must": {
        "low": "366.30",
        "expected": "578.38",
        "high": "1002.96"
      },
      "should": {
        "low": "79.83",
        "expected": "144.82",
        "high": "289.66"
      },
      "could": {
        "low": "43.00",
        "expected": "87.00",
        "high": "176.00"
      },
      "visit_charges": {
        "low": "0.00",
        "expected": "43.80",
        "high": "259.00"
      },
      "subtotal": {
        "low": "489.13",
        "expected": "854.00",
        "high": "1727.62"
      },
      "tax": {
        "low": "0.00",
        "expected": "0.00",
        "high": "0.00"
      },
      "total": {
        "low": "489.13",
        "expected": "854.00",
        "high": "1727.62"
      },
      "approved": null,
      "to_confirm": {
        "low": "0.00",
        "expected": "0.00",
        "high": "0.00"
      },
      "allowances": {
        "low": "0.00",
        "expected": "0.00",
        "high": "0.00"
      }
    },
    "refer_outs": [],
    "trade_scopes": [
      {
        "trade": "pest_control",
        "vendor": null,
        "phase": "trash_out",
        "line_ids": [
          "pest.inspection_treatment@baseline"
        ],
        "lines_cost": {
          "low": "43.00",
          "expected": "87.00",
          "high": "176.00"
        },
        "visit_charges": {
          "low": "0.00",
          "expected": "13.00",
          "high": "88.00"
        },
        "total": {
          "low": "43.00",
          "expected": "100.00",
          "high": "264.00"
        }
      },
      {
        "trade": "handyman",
        "vendor": null,
        "phase": "repairs",
        "line_ids": [
          "drywall.fill_holes_room@f1",
          "hvac.filter_replace_turn@baseline",
          "... 4 more"
        ],
        "lines_cost": {
          "low": "92.88",
          "expected": "182.64",
          "high": "389.74"
        },
        "visit_charges": {
          "low": "0.00",
          "expected": "0.00",
          "high": "0.00"
        },
        "total": {
          "low": "92.88",
          "expected": "182.64",
          "high": "389.74"
        }
      },
      "... 4 more"
    ],
    "lines": [
      {
        "line_id": "pest.inspection_treatment@baseline",
        "task_id": "pest.inspection_treatment",
        "name": "Pest inspection and preventive treatment",
        "trade": "pest_control",
        "phase": "trash_out",
        "priority": "could",
        "location": "Whole unit",
        "finding_ids": [],
        "quantity": "1",
        "uom": "unit",
        "quantity_source": "fixed",
        "price_basis": "unit_price",
        "unit_price": {
          "low": "43.00",
          "expected": "87.00",
          "high": "176.00"
        },
        "cost": {
          "low": "43.00",
          "expected": "87.00",
          "high": "176.00"
        },
        "confidence": "industry_typical",
        "responsibility_hint": "normal_wear",
        "responsibility_by_finding": {},
        "allowance": null,
        "refer_out": null,
        "decision": null,
        "vendor_note": "Licensed applicator.",
        "rule_ids": [
          "region:16740:pest",
          "task:pest.inspection_treatment"
        ],
        "to_confirm": false,
        "needs_review": false
      },
      {
        "line_id": "drywall.fill_holes_room@f1",
        "task_id": "drywall.fill_holes_room",
        "name": "Fill and sand small holes, one room (prep)",
        "trade": "handyman",
        "phase": "repairs",
        "priority": "must",
        "location": "Bedroom",
        "finding_ids": [
          "f1"
        ],
        "quantity": "1",
        "uom": "room",
        "quantity_source": "fixed",
        "price_basis": "unit_price",
        "unit_price": {
          "low": "15.76",
          "expected": "31.52",
          "high": "63.04"
        },
        "cost": {
          "low": "15.76",
          "expected": "31.52",
          "high": "63.04"
        },
        "confidence": "assumed",
        "responsibility_hint": "normal_wear",
        "responsibility_by_finding": {},
        "allowance": null,
        "refer_out": null,
        "decision": null,
        "vendor_note": null,
        "rule_ids": [
          "issue:walls.nail_holes",
          "region:16740:maintenance",
          "... 1 more"
        ],
        "to_confirm": false,
        "needs_review": false
      },
      "... 13 more"
    ],
    "lines_omitted": 0,
    "omitted_note": null,
    "findings": [
      {
        "finding_id": "f1",
        "resolution": "exact",
        "not_billed_reason": null,
        "code": "walls.nail_holes",
        "issue_name": "Small nail, screw or anchor holes in walls",
        "text": "walls.nail_holes",
        "location": "Bedroom",
        "match_note": null,
        "uncertain": false,
        "extent": "partial",
        "suggested_codes": [],
        "suggestions": [],
        "line_ids": [
          "drywall.fill_holes_room@f1",
          "paint.touchup_unit@baseline"
        ],
        "needs_review": false,
        "confidence": null,
        "model": null
      },
      {
        "finding_id": "f2",
        "resolution": "exact",
        "not_billed_reason": null,
        "code": "walls.scuffs",
        "issue_name": "Scuffs, marks and fingerprints on walls",
        "text": "walls.scuffs",
        "location": "Living room",
        "match_note": null,
        "uncertain": false,
        "extent": "spot",
        "suggested_codes": [],
        "suggestions": [],
        "line_ids": [
          "paint.touchup_unit@baseline"
        ],
        "needs_review": false,
        "confidence": null,
        "model": null
      },
      "... 5 more"
    ],
    "assumptions": [
      {
        "code": "floor.carpet_inferred",
        "message": "Carpet presence inferred from carpet findings; pass property.floor_coverings to confirm the carpeted area.",
        "finding_ids": [],
        "line_ids": []
      },
      {
        "code": "line.superseded",
        "message": "'Clean carpet (hot-water extraction)' is covered by 'Clean carpet, whole unit (turn standard)' (420 sq ft cover it).",
        "finding_ids": [],
        "line_ids": [
          "carpet.clean_turn@baseline"
        ]
      },
      "... 3 more"
    ],
    "unknowns": [],
    "rate_card_applied": [],
    "rate_card_ignored": [],
    "detail": "full",
    "region": {
      "zip3": "282",
      "basis": "metro",
      "cbsa": "16740",
      "cbsa_name": "Charlotte-Concord-Gastonia, NC-SC",
      "vintage": "OEWS May 2025"
    },
    "profile": "standard",
    "price_tier": "pm_vendor",
    "provenance": {
      "ruleset_id": "property-turnover",
      "ruleset_version": "pt-2026.11.22",
      "ruleset_hash": "sha256:18529c24a7667efdcc67250c3dac3fe7b956c1c4c6860e56bba0cef2359c054a",
      "sources": [
        {
          "id": "aphanj.rfp-2026",
          "title": "Asbury Park HA, RFP Vacancy Prep Unit Turnover (2026)",
          "url": "https://aphanj.org/wp-content/uploads/2026-INVITATION-FOR-RFP-Vacancy-Prep-Unit-Turnover_.pdf",
          "accessed": "2026-10-07"
        },
        {
          "id": "bid.carpet-clean-5agencies",
          "title": "Carpet-cleaning per-sq-ft bid tabs, five agencies (research 09)",
          "url": null,
          "accessed": "2026-10-07"
        },
        "... 29 more"
      ],
      "rules_as_of": null
    }
  },
  "review": {
    "status": "verified",
    "ai_read": 0,
    "reading_id": null,
    "note": null
  },
  "reading": null,
  "deprecation": null
}
Schemas

Input

{
  "$defs": {
    "Area": {
      "enum": [
        "whole_unit",
        "kitchen",
        "living_room",
        "dining_room",
        "bedroom",
        "bathroom",
        "hallway",
        "entry",
        "laundry",
        "closet",
        "garage",
        "patio_balcony",
        "exterior",
        "yard",
        "other"
      ],
      "title": "Area",
      "type": "string"
    },
    "Constraints": {
      "additionalProperties": false,
      "properties": {
        "target_ready_date": {
          "anyOf": [
            {
              "format": "date",
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Target Ready Date"
        },
        "occupied": {
          "default": false,
          "description": "Work happens while occupied.",
          "title": "Occupied",
          "type": "boolean"
        },
        "access_notes": {
          "anyOf": [
            {
              "maxLength": 500,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Access Notes"
        }
      },
      "title": "Constraints",
      "type": "object"
    },
    "Decision": {
      "additionalProperties": false,
      "description": "Owner decision. Re-run the same request with decisions to get the approved scope.",
      "properties": {
        "line_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Line Id"
        },
        "finding_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Finding Id"
        },
        "action": {
          "enum": [
            "approve",
            "decline",
            "defer"
          ],
          "title": "Action",
          "type": "string"
        },
        "note": {
          "anyOf": [
            {
              "maxLength": 300,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Note"
        }
      },
      "required": [
        "action"
      ],
      "title": "Decision",
      "type": "object"
    },
    "Evidence": {
      "additionalProperties": false,
      "description": "A negative or working result clears: inspector any hazard; lab mold, lead, asbestos, drugs, sewage; meter moisture; self_test or checklist a device.",
      "properties": {
        "kind": {
          "$ref": "#/$defs/EvidenceKind"
        },
        "material": {
          "anyOf": [
            {
              "maxLength": 80,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "What was tested, e.g. 'kitchen floor tile'.",
          "title": "Material"
        },
        "result": {
          "$ref": "#/$defs/EvidenceResult"
        }
      },
      "required": [
        "kind",
        "result"
      ],
      "title": "Evidence",
      "type": "object"
    },
    "EvidenceKind": {
      "enum": [
        "self_test",
        "lab",
        "meter",
        "checklist",
        "inspector"
      ],
      "title": "EvidenceKind",
      "type": "string"
    },
    "EvidenceResult": {
      "enum": [
        "negative",
        "positive",
        "working",
        "failed"
      ],
      "title": "EvidenceResult",
      "type": "string"
    },
    "Extent": {
      "enum": [
        "spot",
        "partial",
        "full"
      ],
      "title": "Extent",
      "type": "string"
    },
    "Extraction": {
      "additionalProperties": false,
      "description": "How our AI reader read a finding; never changes the price.",
      "properties": {
        "method": {
          "description": "ai: free text; ai_document: an upload's page.",
          "enum": [
            "ai",
            "ai_document"
          ],
          "title": "Method",
          "type": "string"
        },
        "model": {
          "description": "The model that read it.",
          "maxLength": 80,
          "pattern": "^[A-Za-z0-9._:() -]+$",
          "title": "Model",
          "type": "string"
        },
        "confidence": {
          "anyOf": [
            {
              "maximum": 1.0,
              "minimum": 0.0,
              "type": "number"
            },
            {
              "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$",
              "type": "string"
            }
          ],
          "description": "0 to 1.",
          "title": "Confidence"
        },
        "page": {
          "anyOf": [
            {
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "ai_document: the page read.",
          "title": "Page"
        },
        "quote": {
          "anyOf": [
            {
              "maxLength": 300,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "ai_document: the row's words, contacts masked.",
          "title": "Quote"
        },
        "cell": {
          "anyOf": [
            {
              "enum": [
                "move_out",
                "move_in",
                "comment"
              ],
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "ai_document: the cell read; move_in bills nothing, a hazard there is Possible.",
          "title": "Cell"
        },
        "review": {
          "anyOf": [
            {
              "$ref": "#/$defs/ExtractionReview"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "ai_document: the person's review."
        },
        "prompt_version": {
          "anyOf": [
            {
              "maxLength": 40,
              "pattern": "^[A-Za-z0-9._:-]+$",
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "The reader's prompt version.",
          "title": "Prompt Version"
        }
      },
      "required": [
        "method",
        "model",
        "confidence"
      ],
      "title": "Extraction",
      "type": "object"
    },
    "ExtractionReview": {
      "additionalProperties": false,
      "description": "A person's review of a finding read from a document.",
      "properties": {
        "outcome": {
          "enum": [
            "confirmed",
            "accepted",
            "edited"
          ],
          "title": "Outcome",
          "type": "string"
        },
        "flags": {
          "description": "Why the page flagged it.",
          "items": {
            "enum": [
              "low_confidence",
              "medium_confidence",
              "quote_not_on_page",
              "count_unread",
              "column_unclear",
              "ok_unclear",
              "unmatched",
              "ai_match"
            ],
            "type": "string"
          },
          "maxItems": 8,
          "title": "Flags",
          "type": "array"
        },
        "changed": {
          "description": "edited: the fields changed.",
          "items": {
            "enum": [
              "description",
              "area",
              "label",
              "extent",
              "quantity"
            ],
            "type": "string"
          },
          "maxItems": 5,
          "title": "Changed",
          "type": "array"
        }
      },
      "required": [
        "outcome"
      ],
      "title": "ExtractionReview",
      "type": "object"
    },
    "Finding": {
      "additionalProperties": false,
      "description": "One observed condition, coded from the issue-code catalog.",
      "properties": {
        "id": {
          "anyOf": [
            {
              "maxLength": 40,
              "pattern": "^[A-Za-z0-9_.:-]+$",
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Your id; defaults to f1, f2, ... in order.",
          "title": "Id"
        },
        "location": {
          "$ref": "#/$defs/Location",
          "description": "{\"area\": \"bedroom\", \"label\": \"Bedroom 2\"} or \"Bedroom 2\"; older form of rooms."
        },
        "code": {
          "anyOf": [
            {
              "maxLength": 80,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "From property_turnover_issue_codes; general.manual_quote if none fits. Send it on every finding.",
          "title": "Code"
        },
        "description": {
          "anyOf": [
            {
              "maxLength": 300,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Deprecated; send code, with the words in source_text.",
          "title": "Description"
        },
        "extent": {
          "anyOf": [
            {
              "$ref": "#/$defs/Extent"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Only when the words say how far; else the code's default."
        },
        "quantity": {
          "anyOf": [
            {
              "$ref": "#/$defs/Quantity"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Measured amount (120 sq_ft), only as the words give it."
        },
        "notes": {
          "anyOf": [
            {
              "maxLength": 1000,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "More words; never billed or coded from.",
          "title": "Notes"
        },
        "extraction": {
          "anyOf": [
            {
              "$ref": "#/$defs/Extraction"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Set by our AI reader; send it back unchanged."
        },
        "confirmed": {
          "default": false,
          "description": "true: the person checked this AI-read finding.",
          "title": "Confirmed",
          "type": "boolean"
        },
        "signature_like": {
          "default": false,
          "description": "Set by our reader; send it back unchanged.",
          "title": "Signature Like",
          "type": "boolean"
        },
        "rooms": {
          "anyOf": [
            {
              "$ref": "#/$defs/Rooms"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Which rooms: {\"area\": \"bedroom\", \"count\": 3} is all 3 bedrooms; labels name them."
        },
        "area_sq_ft": {
          "anyOf": [
            {
              "exclusiveMinimum": 0.0,
              "maximum": 100000.0,
              "type": "number"
            },
            {
              "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$",
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Measured area in sq ft; wins over a derived size.",
          "title": "Area Sq Ft"
        },
        "material": {
          "anyOf": [
            {
              "maxLength": 80,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "The material as written, e.g. '9x9 vinyl tile'.",
          "title": "Material"
        },
        "year_statement": {
          "anyOf": [
            {
              "$ref": "#/$defs/YearStatement"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "A year said in passing (\"built 1972\"); never sets property.year_built."
        },
        "status": {
          "$ref": "#/$defs/FindingStatus",
          "default": "needed",
          "description": "Only needed (the default) bills; on a hazard, done/ok/none without evidence stays Possible."
        },
        "evidence": {
          "anyOf": [
            {
              "$ref": "#/$defs/Evidence"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "The test behind the finding; the only thing that clears a hazard."
        },
        "repeat_of": {
          "anyOf": [
            {
              "maxLength": 40,
              "pattern": "^[A-Za-z0-9_.:-]+$",
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Id of an earlier finding this repeats in its own rooms (\"same as above\"); it bills.",
          "title": "Repeat Of"
        },
        "source_text": {
          "anyOf": [
            {
              "maxLength": 1000,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "The original words. Scanned for hazards; never billed or coded from.",
          "title": "Source Text"
        }
      },
      "title": "Finding",
      "type": "object"
    },
    "FindingStatus": {
      "enum": [
        "needed",
        "done",
        "ok",
        "none"
      ],
      "title": "FindingStatus",
      "type": "string"
    },
    "FloorCoverings": {
      "additionalProperties": false,
      "description": "What is on the floors. Drives the carpet-cleaning baseline and whole-unit carpet sizes.",
      "properties": {
        "carpet_present": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Is there wall-to-wall carpet? Omit if unknown.",
          "title": "Carpet Present"
        },
        "carpet_sq_ft": {
          "anyOf": [
            {
              "maximum": 20000,
              "minimum": 0,
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Carpeted area; omit to assume 60% of the floor area.",
          "title": "Carpet Sq Ft"
        }
      },
      "title": "FloorCoverings",
      "type": "object"
    },
    "Location": {
      "additionalProperties": false,
      "description": "Where; a plain string works too.",
      "properties": {
        "area": {
          "$ref": "#/$defs/Area",
          "default": "whole_unit"
        },
        "label": {
          "anyOf": [
            {
              "maxLength": 60,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "e.g. 'Bedroom 2'.",
          "title": "Label"
        }
      },
      "title": "Location",
      "type": "object"
    },
    "Occupants": {
      "additionalProperties": false,
      "description": "property.occupants: lead-rule facts about the unit; leave out what is unknown.",
      "properties": {
        "child_under_6": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "A child under 6 lives there or is expected to.",
          "title": "Child Under 6"
        },
        "elderly": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Housing for the elderly (62+) or disabled; not just an older tenant.",
          "title": "Elderly"
        },
        "hud_assisted": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Hud Assisted"
        }
      },
      "title": "Occupants",
      "type": "object"
    },
    "PriceTier": {
      "description": "Purchasing channel. Library prices are pm_vendor (a PM buying turns from a local vendor).",
      "enum": [
        "bulk_contract",
        "pm_vendor",
        "retail_one_off"
      ],
      "title": "PriceTier",
      "type": "string"
    },
    "Profile": {
      "enum": [
        "minimum",
        "standard",
        "premium"
      ],
      "title": "Profile",
      "type": "string"
    },
    "PropertyProfile": {
      "additionalProperties": false,
      "properties": {
        "zip": {
          "description": "5-digit US ZIP code (no street address).",
          "pattern": "^\\d{5}$",
          "title": "Zip",
          "type": "string"
        },
        "unit_type": {
          "$ref": "#/$defs/UnitType",
          "default": "apartment",
          "description": "Single-family homes and townhomes get house-sized defaults (floor area, locks)."
        },
        "bedrooms": {
          "description": "0 for a studio.",
          "maximum": 12,
          "minimum": 0,
          "title": "Bedrooms",
          "type": "integer"
        },
        "bathrooms": {
          "anyOf": [
            {
              "maximum": 12.0,
              "minimum": 0.0,
              "multipleOf": 0.5,
              "type": "number"
            },
            {
              "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$",
              "type": "string"
            }
          ],
          "description": "Half baths count as 0.5.",
          "title": "Bathrooms"
        },
        "sq_ft": {
          "anyOf": [
            {
              "maximum": 20000,
              "minimum": 150,
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Interior sq ft.",
          "title": "Sq Ft"
        },
        "year_built": {
          "anyOf": [
            {
              "maximum": 2100,
              "minimum": 1700,
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Drives lead-paint (pre-1978) handling.",
          "title": "Year Built"
        },
        "floor_coverings": {
          "$ref": "#/$defs/FloorCoverings"
        },
        "pets": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Did pets live in the unit? true adds an optional flea treatment. Omit if unknown.",
          "title": "Pets"
        },
        "occupants": {
          "anyOf": [
            {
              "$ref": "#/$defs/Occupants"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "walk_date": {
          "anyOf": [
            {
              "format": "date",
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "The walk-through date; dated or aged items are judged against it. Omit if unknown.",
          "title": "Walk Date"
        }
      },
      "required": [
        "zip",
        "bedrooms",
        "bathrooms"
      ],
      "title": "PropertyProfile",
      "type": "object"
    },
    "Quantity": {
      "additionalProperties": false,
      "properties": {
        "value": {
          "anyOf": [
            {
              "exclusiveMinimum": 0.0,
              "maximum": 100000.0,
              "type": "number"
            },
            {
              "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$",
              "type": "string"
            }
          ],
          "title": "Value"
        },
        "uom": {
          "$ref": "#/$defs/Uom"
        }
      },
      "required": [
        "value",
        "uom"
      ],
      "title": "Quantity",
      "type": "object"
    },
    "RateCardEntry": {
      "additionalProperties": false,
      "description": "Your price for a task_id (from a result line) or a trade, e.g. {\"trade\": \"handyman\", \"unit_price\": 65, \"uom\": \"hour\"}.",
      "properties": {
        "task_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "A task_id from a result line, e.g. 'carpet.clean'.",
          "title": "Task Id"
        },
        "trade": {
          "anyOf": [
            {
              "$ref": "#/$defs/Trade"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "unit_price": {
          "anyOf": [
            {
              "minimum": 0.0,
              "type": "number"
            },
            {
              "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$",
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "USD per uom; on a trade entry, uom 'hour' is its labor rate.",
          "title": "Unit Price"
        },
        "uom": {
          "anyOf": [
            {
              "$ref": "#/$defs/Uom"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Required with a trade unit_price; a task in another uom ignores it."
        },
        "min_charge": {
          "anyOf": [
            {
              "minimum": 0.0,
              "type": "number"
            },
            {
              "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$",
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "USD per trade visit.",
          "title": "Min Charge"
        },
        "trip_charge": {
          "anyOf": [
            {
              "minimum": 0.0,
              "type": "number"
            },
            {
              "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$",
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "USD per trade visit.",
          "title": "Trip Charge"
        }
      },
      "title": "RateCardEntry",
      "type": "object"
    },
    "Rooms": {
      "additionalProperties": false,
      "description": "Which rooms a finding covers.",
      "properties": {
        "area": {
          "$ref": "#/$defs/Area",
          "default": "whole_unit",
          "description": "Left out, from the labels, else the whole unit."
        },
        "labels": {
          "description": "The rooms' names as written, e.g. ['Bedroom 2'].",
          "items": {
            "type": "string"
          },
          "maxItems": 12,
          "title": "Labels",
          "type": "array"
        },
        "count": {
          "default": 1,
          "description": "At least the number of labels; capped at the unit's count.",
          "maximum": 50,
          "minimum": 1,
          "title": "Count",
          "type": "integer"
        }
      },
      "title": "Rooms",
      "type": "object"
    },
    "Standards": {
      "additionalProperties": false,
      "properties": {
        "profile": {
          "$ref": "#/$defs/Profile",
          "default": "standard",
          "description": "minimum (rent-ready basics) | standard | premium (higher finish)."
        },
        "overrides": {
          "$ref": "#/$defs/StandardsOverrides"
        },
        "price_tier": {
          "$ref": "#/$defs/PriceTier",
          "default": "pm_vendor",
          "description": "bulk_contract (portfolio contract prices) | pm_vendor (default: a property manager buying turns from local vendors) | retail_one_off (an owner hiring one contractor)."
        }
      },
      "title": "Standards",
      "type": "object"
    },
    "StandardsOverrides": {
      "additionalProperties": false,
      "properties": {
        "paint_policy": {
          "anyOf": [
            {
              "enum": [
                "touch_up",
                "full_if_needed",
                "always_full"
              ],
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Paint Policy"
        },
        "carpet_policy": {
          "anyOf": [
            {
              "enum": [
                "clean",
                "replace_if_damaged",
                "always_replace"
              ],
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Carpet Policy"
        },
        "cleaning_policy": {
          "anyOf": [
            {
              "enum": [
                "standard",
                "deep"
              ],
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Cleaning Policy"
        },
        "always_rekey": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Always Rekey"
        },
        "markup_pct": {
          "anyOf": [
            {
              "maximum": 100.0,
              "minimum": 0.0,
              "type": "number"
            },
            {
              "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$",
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Management markup applied to every line, %.",
          "title": "Markup Pct"
        }
      },
      "title": "StandardsOverrides",
      "type": "object"
    },
    "Trade": {
      "enum": [
        "hauling",
        "handyman",
        "drywall",
        "painter",
        "flooring",
        "carpet_cleaning",
        "cleaning",
        "appliance",
        "plumber",
        "electrician",
        "hvac",
        "locksmith",
        "pest_control",
        "landscaping",
        "window_glass",
        "environmental",
        "structural"
      ],
      "title": "Trade",
      "type": "string"
    },
    "UnitType": {
      "enum": [
        "apartment",
        "single_family",
        "townhome",
        "condo",
        "duplex",
        "manufactured"
      ],
      "title": "UnitType",
      "type": "string"
    },
    "Uom": {
      "enum": [
        "each",
        "sq_ft",
        "sq_ft_floor",
        "sq_yd",
        "linear_ft",
        "room",
        "unit",
        "bedroom",
        "bathroom",
        "hour",
        "cu_yd",
        "visit"
      ],
      "title": "Uom",
      "type": "string"
    },
    "Vendor": {
      "additionalProperties": false,
      "properties": {
        "name": {
          "maxLength": 120,
          "title": "Name",
          "type": "string"
        },
        "contact": {
          "anyOf": [
            {
              "maxLength": 200,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Contact"
        }
      },
      "required": [
        "name"
      ],
      "title": "Vendor",
      "type": "object"
    },
    "YearStatement": {
      "additionalProperties": false,
      "description": "When the words say it was built.",
      "properties": {
        "text": {
          "description": "The words, e.g. 'built in 1972'.",
          "maxLength": 200,
          "minLength": 1,
          "title": "Text",
          "type": "string"
        },
        "year": {
          "anyOf": [
            {
              "maximum": 2100,
              "minimum": 1700,
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Left out when the words name none ('Victorian').",
          "title": "Year"
        }
      },
      "required": [
        "text"
      ],
      "title": "YearStatement",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "client_refs": {
      "anyOf": [
        {
          "additionalProperties": {
            "type": "string"
          },
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Your own reference ids (e.g. unit_id, job_id). Echoed back, never used.",
      "title": "Client Refs"
    },
    "property": {
      "$ref": "#/$defs/PropertyProfile",
      "description": "The unit: ZIP, size, type and year built."
    },
    "findings": {
      "description": "Move-out inspection findings, one per observed condition, coded.",
      "items": {
        "$ref": "#/$defs/Finding"
      },
      "maxItems": 200,
      "title": "Findings",
      "type": "array"
    },
    "standards": {
      "$ref": "#/$defs/Standards",
      "description": "Finish profile, price tier and overrides."
    },
    "rate_card": {
      "description": "Your own prices by trade or task; they replace the regional library prices.",
      "items": {
        "$ref": "#/$defs/RateCardEntry"
      },
      "maxItems": 300,
      "title": "Rate Card",
      "type": "array"
    },
    "trade_vendors": {
      "additionalProperties": {
        "$ref": "#/$defs/Vendor"
      },
      "description": "Vendor (name, contact) to put on each trade's lines.",
      "propertyNames": {
        "$ref": "#/$defs/Trade"
      },
      "title": "Trade Vendors",
      "type": "object"
    },
    "constraints": {
      "$ref": "#/$defs/Constraints",
      "description": "Target ready date, whether the unit is occupied, access notes."
    },
    "tax_rate": {
      "anyOf": [
        {
          "maximum": 0.2,
          "minimum": 0.0,
          "type": "number"
        },
        {
          "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Applied to all lines, e.g. 0.07.",
      "title": "Tax Rate"
    },
    "decisions": {
      "description": "Approve, decline or defer lines or findings from an earlier scope.",
      "items": {
        "$ref": "#/$defs/Decision"
      },
      "maxItems": 500,
      "title": "Decisions",
      "type": "array"
    },
    "read": {
      "default": "parser",
      "description": "Deprecated and ignored: scope reads no free text.",
      "enum": [
        "parser",
        "ai"
      ],
      "title": "Read",
      "type": "string"
    },
    "retain": {
      "default": true,
      "description": "false: keep none of this request's text.",
      "title": "Retain",
      "type": "boolean"
    },
    "detail": {
      "default": "full",
      "description": "summary (small): totals, trade scopes, lines tied to findings. full: all.",
      "enum": [
        "summary",
        "full"
      ],
      "title": "Detail",
      "type": "string"
    }
  },
  "required": [
    "property"
  ],
  "title": "ScopeRequest",
  "type": "object"
}

Output

{
  "$defs": {
    "CostRange": {
      "description": "A low / expected / high estimate. Invariant: low <= expected <= high.",
      "properties": {
        "low": {
          "title": "Low",
          "type": "string"
        },
        "expected": {
          "title": "Expected",
          "type": "string"
        },
        "high": {
          "title": "High",
          "type": "string"
        }
      },
      "required": [
        "low",
        "expected",
        "high"
      ],
      "title": "CostRange",
      "type": "object"
    },
    "Extent": {
      "enum": [
        "spot",
        "partial",
        "full"
      ],
      "title": "Extent",
      "type": "string"
    },
    "FindingResolution": {
      "properties": {
        "finding_id": {
          "title": "Finding Id",
          "type": "string"
        },
        "resolution": {
          "description": "exact: a taxonomy code was given. alias: the description matched an alias. ai: an AI reader chose the code from free text (see confidence, model; needs_review). unmapped: nothing matched (a manual-quote line). not_billed: the description says there is no work ('no mold', 'faucet not leaking', 'fixed by tenant'), or names no condition at all (a heading, a date, a signature, a year built); no lines, no refer-out; the issue it names is in suggestions and the reason in not_billed_reason.",
          "enum": [
            "exact",
            "alias",
            "ai",
            "unmapped",
            "not_billed"
          ],
          "title": "Resolution",
          "type": "string"
        },
        "not_billed_reason": {
          "anyOf": [
            {
              "enum": [
                "none",
                "ok",
                "done",
                "no_condition"
              ],
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "resolution 'not_billed' only. none: says there is none ('no mold', 'mold: none'); ok: says it works or is fine; done: says it was already fixed or done; no_condition: names no condition, only a heading, small talk, a signature or the year built ('Unit 4B - Move-out inspection', 'Built 1972'), see match_note (contract 0.13.0, additive).",
          "title": "Not Billed Reason"
        },
        "code": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Code"
        },
        "issue_name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Readable name of `code`.",
          "title": "Issue Name"
        },
        "text": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "The finding as given (description, else code), for tracing.",
          "title": "Text"
        },
        "location": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Where, as shown on the lines.",
          "title": "Location"
        },
        "match_note": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Set when the match left a fixture word unexplained: check this finding.",
          "title": "Match Note"
        },
        "uncertain": {
          "default": false,
          "description": "The description hedges ('mold?', 'maybe', 'possible'). Refer-outs from uncertain findings are check-first: they add a warning instead of holding phases.",
          "title": "Uncertain",
          "type": "boolean"
        },
        "extent": {
          "anyOf": [
            {
              "$ref": "#/$defs/Extent"
            },
            {
              "type": "null"
            }
          ]
        },
        "suggested_codes": {
          "default": [],
          "items": {
            "type": "string"
          },
          "title": "Suggested Codes",
          "type": "array"
        },
        "suggestions": {
          "description": "Suggested codes with readable names, best first.",
          "items": {
            "$ref": "#/$defs/Suggestion"
          },
          "title": "Suggestions",
          "type": "array"
        },
        "line_ids": {
          "default": [],
          "items": {
            "type": "string"
          },
          "title": "Line Ids",
          "type": "array"
        },
        "needs_review": {
          "default": false,
          "description": "True when software read this finding from free text (resolution 'ai'): check it.",
          "title": "Needs Review",
          "type": "boolean"
        },
        "confidence": {
          "anyOf": [
            {
              "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$",
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "resolution 'ai' only: the AI reader's confidence, 0 to 1.",
          "title": "Confidence"
        },
        "model": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "resolution 'ai' only: the model used.",
          "title": "Model"
        },
        "confirmed": {
          "default": false,
          "description": "Read by AI and confirmed by the person (sent with confirmed: true).",
          "title": "Confirmed",
          "type": "boolean"
        }
      },
      "required": [
        "finding_id",
        "resolution",
        "code",
        "extent"
      ],
      "title": "FindingResolution",
      "type": "object"
    },
    "Note": {
      "properties": {
        "code": {
          "title": "Code",
          "type": "string"
        },
        "message": {
          "title": "Message",
          "type": "string"
        },
        "finding_ids": {
          "default": [],
          "items": {
            "type": "string"
          },
          "title": "Finding Ids",
          "type": "array"
        },
        "line_ids": {
          "default": [],
          "items": {
            "type": "string"
          },
          "title": "Line Ids",
          "type": "array"
        }
      },
      "required": [
        "code",
        "message"
      ],
      "title": "Note",
      "type": "object"
    },
    "Phase": {
      "description": "Make-ready order. Values sort in sequence order via PHASE_ORDER.",
      "enum": [
        "assess",
        "trash_out",
        "repairs",
        "paint",
        "flooring",
        "appliances",
        "cleaning",
        "punch",
        "rekey"
      ],
      "title": "Phase",
      "type": "string"
    },
    "PriceBasis": {
      "enum": [
        "rate_card",
        "unit_price",
        "labor_derived",
        "placeholder"
      ],
      "title": "PriceBasis",
      "type": "string"
    },
    "PriceTier": {
      "description": "Purchasing channel. Library prices are pm_vendor (a PM buying turns from a local vendor).",
      "enum": [
        "bulk_contract",
        "pm_vendor",
        "retail_one_off"
      ],
      "title": "PriceTier",
      "type": "string"
    },
    "Priority": {
      "enum": [
        "must",
        "should",
        "could"
      ],
      "title": "Priority",
      "type": "string"
    },
    "Profile": {
      "enum": [
        "minimum",
        "standard",
        "premium"
      ],
      "title": "Profile",
      "type": "string"
    },
    "Provenance": {
      "properties": {
        "ruleset_id": {
          "title": "Ruleset Id",
          "type": "string"
        },
        "ruleset_version": {
          "title": "Ruleset Version",
          "type": "string"
        },
        "ruleset_hash": {
          "title": "Ruleset Hash",
          "type": "string"
        },
        "sources": {
          "items": {
            "$ref": "#/$defs/SourceRef"
          },
          "title": "Sources",
          "type": "array"
        },
        "rules_as_of": {
          "anyOf": [
            {
              "format": "date",
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "The oldest reading of the sources behind the legal items in this result (refer-outs and state mandates): the rules are as of this date. None when the result states no legal rule.",
          "title": "Rules As Of"
        }
      },
      "required": [
        "ruleset_id",
        "ruleset_version",
        "ruleset_hash",
        "sources"
      ],
      "title": "Provenance",
      "type": "object"
    },
    "RateCardUse": {
      "properties": {
        "entry": {
          "description": "0-based index into the request's rate_card.",
          "title": "Entry",
          "type": "integer"
        },
        "target": {
          "description": "The entry's task_id or trade.",
          "title": "Target",
          "type": "string"
        },
        "lines": {
          "default": [],
          "items": {
            "type": "string"
          },
          "title": "Lines",
          "type": "array"
        },
        "note": {
          "title": "Note",
          "type": "string"
        }
      },
      "required": [
        "entry",
        "target",
        "note"
      ],
      "title": "RateCardUse",
      "type": "object"
    },
    "ReferOutNote": {
      "properties": {
        "id": {
          "title": "Id",
          "type": "string"
        },
        "name": {
          "title": "Name",
          "type": "string"
        },
        "professional": {
          "title": "Professional",
          "type": "string"
        },
        "reason": {
          "title": "Reason",
          "type": "string"
        },
        "kind": {
          "enum": [
            "assessment",
            "compliance"
          ],
          "title": "Kind",
          "type": "string"
        },
        "finding_ids": {
          "items": {
            "type": "string"
          },
          "title": "Finding Ids",
          "type": "array"
        },
        "blocks_phases": {
          "items": {
            "$ref": "#/$defs/Phase"
          },
          "title": "Blocks Phases",
          "type": "array"
        },
        "sources": {
          "items": {
            "type": "string"
          },
          "title": "Sources",
          "type": "array"
        },
        "unconfirmed": {
          "default": false,
          "description": "No finding confirms it: every finding that raised it was hedged ('maybe', '?'), named the hazard only in its words (description, notes or location label) rather than through its issue code, or stated an older year built than the request. Check first; no phase is held until the condition is confirmed (see warnings).",
          "title": "Unconfirmed",
          "type": "boolean"
        }
      },
      "required": [
        "id",
        "name",
        "professional",
        "reason",
        "kind",
        "finding_ids",
        "blocks_phases",
        "sources"
      ],
      "title": "ReferOutNote",
      "type": "object"
    },
    "Region": {
      "properties": {
        "zip3": {
          "title": "Zip3",
          "type": "string"
        },
        "basis": {
          "enum": [
            "metro",
            "nonmetro",
            "national"
          ],
          "title": "Basis",
          "type": "string"
        },
        "cbsa": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Cbsa"
        },
        "cbsa_name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Cbsa Name"
        },
        "vintage": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Vintage"
        }
      },
      "required": [
        "zip3",
        "basis"
      ],
      "title": "Region",
      "type": "object"
    },
    "Responsibility": {
      "enum": [
        "normal_wear",
        "likely_damage",
        "elective",
        "undetermined",
        "mixed"
      ],
      "title": "Responsibility",
      "type": "string"
    },
    "ScopeLine": {
      "properties": {
        "line_id": {
          "title": "Line Id",
          "type": "string"
        },
        "task_id": {
          "title": "Task Id",
          "type": "string"
        },
        "name": {
          "title": "Name",
          "type": "string"
        },
        "trade": {
          "$ref": "#/$defs/Trade"
        },
        "phase": {
          "$ref": "#/$defs/Phase"
        },
        "priority": {
          "$ref": "#/$defs/Priority"
        },
        "location": {
          "title": "Location",
          "type": "string"
        },
        "finding_ids": {
          "items": {
            "type": "string"
          },
          "title": "Finding Ids",
          "type": "array"
        },
        "quantity": {
          "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$",
          "title": "Quantity",
          "type": "string"
        },
        "uom": {
          "$ref": "#/$defs/Uom"
        },
        "quantity_source": {
          "enum": [
            "given",
            "converted",
            "derived",
            "fixed"
          ],
          "title": "Quantity Source",
          "type": "string"
        },
        "price_basis": {
          "$ref": "#/$defs/PriceBasis"
        },
        "unit_price": {
          "$ref": "#/$defs/CostRange"
        },
        "cost": {
          "$ref": "#/$defs/CostRange"
        },
        "confidence": {
          "enum": [
            "sourced",
            "industry_typical",
            "assumed"
          ],
          "title": "Confidence",
          "type": "string"
        },
        "responsibility_hint": {
          "$ref": "#/$defs/Responsibility"
        },
        "responsibility_by_finding": {
          "additionalProperties": {
            "$ref": "#/$defs/Responsibility"
          },
          "description": "Set when the hint is 'mixed': the hint of each finding the line carries.",
          "title": "Responsibility By Finding",
          "type": "object"
        },
        "allowance": {
          "anyOf": [
            {
              "$ref": "#/$defs/CostRange"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Quote-required lines only: a non-binding budget range. NOT included in any total; summed separately in totals.allowances."
        },
        "refer_out": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Refer Out"
        },
        "decision": {
          "anyOf": [
            {
              "enum": [
                "approve",
                "decline",
                "defer"
              ],
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Decision"
        },
        "vendor_note": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Vendor Note"
        },
        "rule_ids": {
          "items": {
            "type": "string"
          },
          "title": "Rule Ids",
          "type": "array"
        },
        "to_confirm": {
          "default": false,
          "description": "Every finding behind this line is uncertain, or it is a check-first assessment from the safety net: priced, but not in must/should/could, subtotal or total (see totals.to_confirm).",
          "title": "To Confirm",
          "type": "boolean"
        },
        "needs_review": {
          "default": false,
          "description": "A finding behind this line was read by AI from free text: check it.",
          "title": "Needs Review",
          "type": "boolean"
        }
      },
      "required": [
        "line_id",
        "task_id",
        "name",
        "trade",
        "phase",
        "priority",
        "location",
        "finding_ids",
        "quantity",
        "uom",
        "quantity_source",
        "price_basis",
        "unit_price",
        "cost",
        "confidence",
        "responsibility_hint",
        "rule_ids"
      ],
      "title": "ScopeLine",
      "type": "object"
    },
    "SourceRef": {
      "properties": {
        "id": {
          "title": "Id",
          "type": "string"
        },
        "title": {
          "title": "Title",
          "type": "string"
        },
        "url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Url"
        },
        "accessed": {
          "anyOf": [
            {
              "format": "date",
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "When the source was last read.",
          "title": "Accessed"
        }
      },
      "required": [
        "id",
        "title"
      ],
      "title": "SourceRef",
      "type": "object"
    },
    "Suggestion": {
      "properties": {
        "code": {
          "title": "Code",
          "type": "string"
        },
        "name": {
          "title": "Name",
          "type": "string"
        }
      },
      "required": [
        "code",
        "name"
      ],
      "title": "Suggestion",
      "type": "object"
    },
    "Totals": {
      "properties": {
        "note": {
          "default": "must, should and could are work lines only. visit_charges (minimum call-out and trip fees, once per trade) are added on top: subtotal = must + should + could + visit_charges; total = subtotal + tax. allowances and to_confirm (uncertain items) are outside the total.",
          "description": "How the totals add up.",
          "title": "Note",
          "type": "string"
        },
        "must": {
          "$ref": "#/$defs/CostRange"
        },
        "should": {
          "$ref": "#/$defs/CostRange"
        },
        "could": {
          "$ref": "#/$defs/CostRange"
        },
        "visit_charges": {
          "$ref": "#/$defs/CostRange"
        },
        "subtotal": {
          "$ref": "#/$defs/CostRange"
        },
        "tax": {
          "$ref": "#/$defs/CostRange"
        },
        "total": {
          "$ref": "#/$defs/CostRange"
        },
        "approved": {
          "anyOf": [
            {
              "$ref": "#/$defs/CostRange"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "to_confirm": {
          "$ref": "#/$defs/CostRange",
          "description": "Lines from uncertain findings ('maybe', '?', 'possible') and safety items read from plain words (the refer-out safety net): priced, but outside every total until confirmed on site. Those lines carry to_confirm: true (contract 0.7.0)."
        },
        "allowances": {
          "$ref": "#/$defs/CostRange",
          "description": "Budget allowance for quote-required lines (refer-outs, manual quotes). Shown outside the totals: subtotal and total never include it."
        }
      },
      "required": [
        "must",
        "should",
        "could",
        "visit_charges",
        "subtotal",
        "tax",
        "total"
      ],
      "title": "Totals",
      "type": "object"
    },
    "Trade": {
      "enum": [
        "hauling",
        "handyman",
        "drywall",
        "painter",
        "flooring",
        "carpet_cleaning",
        "cleaning",
        "appliance",
        "plumber",
        "electrician",
        "hvac",
        "locksmith",
        "pest_control",
        "landscaping",
        "window_glass",
        "environmental",
        "structural"
      ],
      "title": "Trade",
      "type": "string"
    },
    "TradeScope": {
      "properties": {
        "trade": {
          "$ref": "#/$defs/Trade"
        },
        "vendor": {
          "anyOf": [
            {
              "$ref": "#/$defs/Vendor"
            },
            {
              "type": "null"
            }
          ]
        },
        "phase": {
          "$ref": "#/$defs/Phase"
        },
        "line_ids": {
          "items": {
            "type": "string"
          },
          "title": "Line Ids",
          "type": "array"
        },
        "lines_cost": {
          "$ref": "#/$defs/CostRange"
        },
        "visit_charges": {
          "$ref": "#/$defs/CostRange"
        },
        "total": {
          "$ref": "#/$defs/CostRange"
        }
      },
      "required": [
        "trade",
        "vendor",
        "phase",
        "line_ids",
        "lines_cost",
        "visit_charges",
        "total"
      ],
      "title": "TradeScope",
      "type": "object"
    },
    "Uom": {
      "enum": [
        "each",
        "sq_ft",
        "sq_ft_floor",
        "sq_yd",
        "linear_ft",
        "room",
        "unit",
        "bedroom",
        "bathroom",
        "hour",
        "cu_yd",
        "visit"
      ],
      "title": "Uom",
      "type": "string"
    },
    "Vendor": {
      "additionalProperties": false,
      "properties": {
        "name": {
          "maxLength": 120,
          "title": "Name",
          "type": "string"
        },
        "contact": {
          "anyOf": [
            {
              "maxLength": 200,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Contact"
        }
      },
      "required": [
        "name"
      ],
      "title": "Vendor",
      "type": "object"
    }
  },
  "description": "Field order puts the answer first (summary, disclaimer, totals, refer-outs, vendor\nscopes), because agents and truncating clients read from the top.",
  "properties": {
    "summary": {
      "title": "Summary",
      "type": "string"
    },
    "disclaimer": {
      "title": "Disclaimer",
      "type": "string"
    },
    "warnings": {
      "items": {
        "$ref": "#/$defs/Note"
      },
      "title": "Warnings",
      "type": "array"
    },
    "totals": {
      "$ref": "#/$defs/Totals"
    },
    "refer_outs": {
      "items": {
        "$ref": "#/$defs/ReferOutNote"
      },
      "title": "Refer Outs",
      "type": "array"
    },
    "trade_scopes": {
      "items": {
        "$ref": "#/$defs/TradeScope"
      },
      "title": "Trade Scopes",
      "type": "array"
    },
    "lines": {
      "items": {
        "$ref": "#/$defs/ScopeLine"
      },
      "title": "Lines",
      "type": "array"
    },
    "lines_omitted": {
      "description": "Lines left out in summary detail.",
      "title": "Lines Omitted",
      "type": "integer"
    },
    "omitted_note": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Summary detail: what the omitted lines are (routine turn tasks) and their cost.",
      "title": "Omitted Note"
    },
    "findings": {
      "items": {
        "$ref": "#/$defs/FindingResolution"
      },
      "title": "Findings",
      "type": "array"
    },
    "assumptions": {
      "items": {
        "$ref": "#/$defs/Note"
      },
      "title": "Assumptions",
      "type": "array"
    },
    "unknowns": {
      "items": {
        "$ref": "#/$defs/Note"
      },
      "title": "Unknowns",
      "type": "array"
    },
    "rate_card_applied": {
      "description": "Rate card entries that changed a price.",
      "items": {
        "$ref": "#/$defs/RateCardUse"
      },
      "title": "Rate Card Applied",
      "type": "array"
    },
    "rate_card_ignored": {
      "description": "Rate card entries that changed nothing, with why.",
      "items": {
        "$ref": "#/$defs/RateCardUse"
      },
      "title": "Rate Card Ignored",
      "type": "array"
    },
    "detail": {
      "enum": [
        "summary",
        "full"
      ],
      "title": "Detail",
      "type": "string"
    },
    "region": {
      "$ref": "#/$defs/Region"
    },
    "profile": {
      "$ref": "#/$defs/Profile"
    },
    "price_tier": {
      "$ref": "#/$defs/PriceTier",
      "default": "pm_vendor"
    },
    "provenance": {
      "$ref": "#/$defs/Provenance"
    }
  },
  "required": [
    "summary",
    "disclaimer",
    "warnings",
    "totals",
    "refer_outs",
    "trade_scopes",
    "lines",
    "lines_omitted",
    "findings",
    "assumptions",
    "unknowns",
    "detail",
    "region",
    "profile",
    "provenance"
  ],
  "title": "ScopeResult",
  "type": "object"
}
issue_codeskind: deterministic, limits: 30/min · not counted, price per call: Free

Look up turnover issue codes. The issue-code catalog for rental-unit turnover (group.issue codes such as carpet.pet_urine): list every code, or search by words for full detail.

Use it when: While preparing findings for a turnover cost estimate, to map each observed condition to one code before sending it to scope. Search with q for the detail (description, aliases, when not to use it, examples); call with no arguments for the short list of every code. Never needed to answer a question.

Not for: Legal or security-deposit questions; anything outside rental turnover and make-ready work. Not needed before quick_estimate, which reads plain words.

  • Map each observed condition to one code; search with q when unsure, and read not_when.
  • When no code fits, send general.manual_quote and keep the original words.
  • Call with no arguments for the short list of every code and the groups.
REST
POST /v1/property-turnover/issue_codes
MCP tool
property_turnover_issue_codes
Schemas
input · output
Limits
30/min · not counted
Price per call
Free
Schemas

Input

{
  "additionalProperties": false,
  "properties": {
    "client_refs": {
      "anyOf": [
        {
          "additionalProperties": {
            "type": "string"
          },
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Your own reference ids (e.g. unit_id, job_id). Echoed back, never used.",
      "title": "Client Refs"
    },
    "q": {
      "anyOf": [
        {
          "maxLength": 200,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Words to search for in the codes, names, aliases, descriptions and examples, e.g. 'pet stain carpet'. Hits come back with full detail. Leave out to list every code in short form.",
      "title": "Q"
    },
    "group": {
      "anyOf": [
        {
          "maxLength": 40,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Only codes in this group, e.g. 'flooring' or 'walls' (a part of the unit, not a room). `groups` in the answer lists them all.",
      "title": "Group"
    },
    "limit": {
      "anyOf": [
        {
          "maximum": 500,
          "minimum": 1,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Most codes to return. Default: 8 with q, every code without.",
      "title": "Limit"
    },
    "include_aliases": {
      "default": false,
      "description": "Also return aliases in the short list (search hits always carry them).",
      "title": "Include Aliases",
      "type": "boolean"
    },
    "query": {
      "anyOf": [
        {
          "maxLength": 200,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Older name for q; use q.",
      "title": "Query"
    },
    "area": {
      "anyOf": [
        {
          "maxLength": 40,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Older name for group; use group.",
      "title": "Area"
    }
  },
  "title": "IssueCodesRequest",
  "type": "object"
}

Output

{
  "$defs": {
    "IssueCode": {
      "description": "One catalog entry. The short list carries code, name, group, default_extent and, where\nthe code has them, refer_out and rooms; a search hit (``q``) carries every field. Fields with\nnothing to say are left out of the JSON.",
      "properties": {
        "code": {
          "description": "Stable code, group.issue, e.g. 'carpet.pet_urine'.",
          "title": "Code",
          "type": "string"
        },
        "name": {
          "title": "Name",
          "type": "string"
        },
        "group": {
          "description": "The part of the unit it belongs to, for the group filter.",
          "title": "Group",
          "type": "string"
        },
        "description": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "What the code covers, in plain words.",
          "title": "Description"
        },
        "aliases": {
          "description": "Other words for it.",
          "items": {
            "type": "string"
          },
          "title": "Aliases",
          "type": "array"
        },
        "not_when": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "When not to use it, in plain words.",
          "title": "Not When"
        },
        "rooms": {
          "description": "The rooms it is for; empty means any room.",
          "items": {
            "type": "string"
          },
          "title": "Rooms",
          "type": "array"
        },
        "default_extent": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "spot | partial | full, used when a finding sends none.",
          "title": "Default Extent"
        },
        "refer_out": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "The refer-out (licensed pro or compliance step) this code raises, if any.",
          "title": "Refer Out"
        },
        "examples": {
          "description": "Notes this code is for, as inspectors write them.",
          "items": {
            "type": "string"
          },
          "title": "Examples",
          "type": "array"
        }
      },
      "required": [
        "code",
        "name",
        "group"
      ],
      "title": "IssueCode",
      "type": "object"
    }
  },
  "properties": {
    "ruleset_version": {
      "title": "Ruleset Version",
      "type": "string"
    },
    "total_matches": {
      "description": "Codes matching q and group, before limit.",
      "title": "Total Matches",
      "type": "integer"
    },
    "codes": {
      "items": {
        "$ref": "#/$defs/IssueCode"
      },
      "title": "Codes",
      "type": "array"
    },
    "groups": {
      "description": "Every group, for the group filter.",
      "items": {
        "type": "string"
      },
      "title": "Groups",
      "type": "array"
    },
    "areas": {
      "description": "Older name for groups (the same list).",
      "items": {
        "type": "string"
      },
      "title": "Areas",
      "type": "array"
    },
    "manual_quote_code": {
      "default": "general.manual_quote",
      "description": "The code to send when no code fits; the line is quoted by hand.",
      "title": "Manual Quote Code",
      "type": "string"
    },
    "note": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Note"
    }
  },
  "required": [
    "ruleset_version",
    "total_matches",
    "codes"
  ],
  "title": "IssueCodesResult",
  "type": "object"
}

Pricing and limits

  • Web tools: free to try, 3 a day on the web (estimates and downloads count together).
  • AI assistants and API: 5 calls a day free per client, counted together (the paid lane is in testing; the free tier applies meanwhile).
  • More than the free tier: contact us.

Pricing

Limits are per client. MCP allows 240 calls a minute (hosted assistants share addresses). The daily free tier counts REST and MCP calls together (per person when the assistant says who is asking, a shared pool for assistants that don't, else per address) and resets at midnight UTC; over it, REST answers 429 free_tier_exhausted and MCP a tool error, both naming the reset time and the paid route. Responses under it carry X-TK-Free-Remaining.

Accuracy and rules

  • Coverage: US
  • Determinism: strict for the rules: the same findings always give the same answer. An AI model may read notes into findings, marked for review; it never sets a number.
  • Contract version: 1.0.0 (experimental)
  • How it works: pipeline, counts, confidence mix and every source.
  • Ruleset: pt-2026.11.22, hash sha256:18529c24a7667efdcc67250c3dac3fe7b956c1c4c6860e56bba0cef2359c054a. Every result is stamped with these, so the same findings always reproduce the same result.
Sources cited by the ruleset (205)

Limitations

  • Estimate ranges, not quotes. Prices vary by vendor, market and condition.
  • Does not diagnose structural, electrical, gas, mold, asbestos or lead hazards; those are referred to licensed professionals.
  • Responsibility labels (wear vs damage) are hints, not legal determinations; deposit rules vary by state.
  • This is not legal advice. Check the linked sources before you rely on it. You decide, sign and send.

Results are estimate ranges for planning, not quotes or professional advice. Read the full disclaimer.

Privacy

  • Estimates: We keep an anonymized record of estimates (ZIP3, unit size, findings and totals) and, on the turnover tool, the text you type with contact details and access codes removed, to improve matching. Never your address, IP or contact details; you can opt out.
  • Retention: 730 days.
  • Notes: The text you type (your notes, or an agent's list of issues) is kept with contact details, addresses, unit numbers and access codes removed, linked to the findings it became, for up to 5 years, to improve matching and measure accuracy. Opt out with the page's "Don't keep my notes" box or retain: false.
  • Used to train models: no
  • Personal data: Inputs need a ZIP code, not an address. Request bodies are never logged. The text of findings and notes is kept with contact details and access codes removed, for up to 5 years, to improve matching, unless the request sets retain: false. Each estimate leaves one anonymized record: first 3 digits of the ZIP, size and age in coarse buckets, issue codes, totals and a daily-rotating anonymous client fingerprint; no notes, labels, names, vendors, rate-card prices, IP address or user agent. Descriptions of issues the taxonomy could not match are kept with digits, emails and links removed. These records are deleted 730 days after they are written and are not used to train models. Optional feedback (a rating, a note, an email only if typed) is stored separately, with a few estimate identifiers (hashes, versions, region, total) but never the request or notes. The web tool's optional AI reader ("Describe the unit in your own words") sends that text, with the unit's size and the walk date, to Microsoft Azure OpenAI (gpt-6-luna, US data zone) and stores its answer to reuse for the same text (not for opted-out requests); Microsoft does not use it to train models.

Have a task you wish a reliable tool handled? Tell us on the Contact page.