View input schema
{
"type": "object",
"properties": {
"address": {
"maxLength": 300,
"minLength": 1,
"type": "string"
},
"comp_radius_miles": {
"anyOf": [
{
"maximum": 5,
"minimum": 0.1,
"type": "number"
},
{
"type": "null"
}
],
"default": null
},
"condition": {
"anyOf": [
{
"$ref": "#/$defs/V1Condition"
},
{
"type": "null"
}
],
"default": null
},
"confirm_pin": {
"anyOf": [
{
"maxLength": 64,
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"exclude_comps": {
"items": {
"type": "string"
},
"maxItems": 50,
"type": "array"
},
"facts": {
"anyOf": [
{
"$ref": "#/$defs/V1Facts"
},
{
"type": "null"
}
],
"default": null
},
"fresh": {
"default": false,
"type": "boolean"
},
"include": {
"items": {
"const": "narrative",
"type": "string"
},
"type": "array"
},
"include_comps": {
"items": {
"$ref": "#/$defs/CallerComp"
},
"maxItems": 10,
"type": "array"
},
"list_date": {
"anyOf": [
{
"format": "date",
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"list_price": {
"anyOf": [
{
"maximum": 100000000,
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"default": null
},
"manual_pin_override": {
"anyOf": [
{
"maxLength": 64,
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"personas": {
"items": {
"enum": [
"buyer",
"seller",
"investor"
],
"type": "string"
},
"type": "array"
},
"previous_sale": {
"anyOf": [
{
"$ref": "#/$defs/V1PreviousSale"
},
{
"type": "null"
}
],
"default": null
},
"priorities": {
"anyOf": [
{
"$ref": "#/$defs/UserPriorities"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"address"
],
"$defs": {
"CallerComp": {
"description": "A sale the caller supplies as a comp (v1 ``include_comps``). Entirely the caller's own facts, marked provenance ``user``; nothing is looked up for it.",
"properties": {
"address": {
"maxLength": 300,
"minLength": 1,
"type": "string"
},
"baths": {
"anyOf": [
{
"maximum": 20,
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"default": null
},
"beds": {
"anyOf": [
{
"maximum": 20,
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null
},
"lot_sqft": {
"anyOf": [
{
"maximum": 100000000,
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
],
"default": null
},
"sale_date": {
"format": "date",
"type": "string"
},
"sale_price": {
"exclusiveMinimum": 0,
"maximum": 100000000,
"type": "number"
},
"sqft": {
"anyOf": [
{
"maximum": 50000,
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
],
"default": null
},
"year_built": {
"anyOf": [
{
"maximum": 2100,
"minimum": 1700,
"type": "integer"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"address",
"sale_price",
"sale_date"
],
"type": "object"
},
"CommuteDestination": {
"properties": {
"address": {
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"max_minutes": {
"maximum": 240,
"minimum": 1,
"type": "integer"
},
"mode": {
"enum": [
"driving",
"transit",
"either"
],
"type": "string"
}
},
"required": [
"address",
"max_minutes",
"mode"
],
"type": "object"
},
"UserPriorities": {
"description": "Optional user-provided priorities.\n\nIf None or all fields empty, the report omits section 12 entirely.",
"properties": {
"commute_destinations": {
"items": {
"$ref": "#/$defs/CommuteDestination"
},
"maxItems": 3,
"type": "array"
},
"layout_needs": {
"items": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"maxItems": 10,
"type": "array"
},
"other_priorities": {
"anyOf": [
{
"maxLength": 600,
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"purpose": {
"anyOf": [
{
"enum": [
"primary_residence",
"investment",
"flip",
"second_home"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"type": "object"
},
"V1Condition": {
"additionalProperties": false,
"description": "The condition intake exactly as the internal API takes it, plus the three rental and teardown answers the internal request keeps beside it.",
"properties": {
"actual_monthly_rent_per_unit": {
"anyOf": [
{
"maximum": 100000,
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"default": null
},
"actual_rent": {
"anyOf": [
{
"maximum": 100000,
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"default": null
},
"air_conditioning_type": {
"anyOf": [
{
"enum": [
"window_units",
"central",
"heat_pump",
"mini_split",
"none"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"bath_updated": {
"anyOf": [
{
"enum": [
"lt_5yr",
"5_10yr",
"original"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"buyer_down_payment_amount": {
"anyOf": [
{
"maximum": 100000000,
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"default": null
},
"buyer_down_payment_pct": {
"anyOf": [
{
"maximum": 100,
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"default": null
},
"buyer_interest_rate_pct": {
"anyOf": [
{
"maximum": 25,
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"default": null
},
"buyer_loan_term_years": {
"anyOf": [
{
"enum": [
15,
20,
30
],
"type": "integer"
},
{
"type": "null"
}
],
"default": null
},
"confirmed_not_listed": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null
},
"coop_flip_tax_pct": {
"anyOf": [
{
"maximum": 25,
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"default": null
},
"coop_min_down_payment_pct": {
"anyOf": [
{
"maximum": 100,
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"default": null
},
"electrical_panel_age_years": {
"anyOf": [
{
"maximum": 150,
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null
},
"electrical_panel_amperage": {
"anyOf": [
{
"enum": [
"60",
"100",
"150",
"200",
"400"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"finished_basement_sqft": {
"anyOf": [
{
"maximum": 20000,
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null
},
"foundation_type_confirmed": {
"anyOf": [
{
"enum": [
"full_basement",
"partial_basement",
"crawl_space",
"slab",
"other"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"garage_type_confirmed": {
"anyOf": [
{
"enum": [
"attached",
"detached",
"none"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"hvac_age_years": {
"anyOf": [
{
"maximum": 150,
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null
},
"kitchen_updated": {
"anyOf": [
{
"enum": [
"lt_5yr",
"5_10yr",
"original"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"known_issues": {
"items": {
"enum": [
"basement_water",
"foundation_repair",
"insurance_claim",
"roof_leak",
"mold"
],
"type": "string"
},
"maxItems": 5,
"type": "array"
},
"lead_pipes_present": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null
},
"lease_end_date": {
"anyOf": [
{
"format": "date",
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"monthly_hoa_dues": {
"anyOf": [
{
"maximum": 50000,
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"default": null
},
"monthly_maintenance": {
"anyOf": [
{
"maximum": 100000,
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"default": null
},
"overall_condition": {
"anyOf": [
{
"enum": [
"move_in",
"well_maintained",
"dated",
"needs_work"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"parking_spaces": {
"anyOf": [
{
"maximum": 50,
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null
},
"renovation_scope": {
"anyOf": [
{
"enum": [
"none",
"cosmetic",
"major_gut"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"rentable_unit_count": {
"anyOf": [
{
"maximum": 50,
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null
},
"rentable_units": {
"anyOf": [
{
"maximum": 50,
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null
},
"roof_age_years": {
"anyOf": [
{
"maximum": 150,
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null
},
"roof_type_confirmed": {
"anyOf": [
{
"enum": [
"asphalt_shingle",
"metal",
"flat_membrane",
"tile",
"slate",
"wood_shake",
"other"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"sewer_type": {
"anyOf": [
{
"enum": [
"municipal",
"septic"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"solar": {
"anyOf": [
{
"enum": [
"owned",
"leased",
"none"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"teardown_confirmed": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null
},
"tenant_occupied": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null
},
"water_heater_age_years": {
"anyOf": [
{
"maximum": 150,
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null
},
"water_source": {
"anyOf": [
{
"enum": [
"municipal",
"well"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"type": "object"
},
"V1Facts": {
"additionalProperties": false,
"description": "Property facts the caller knows. ``beds``, ``baths``, ``sqft`` and ``year_built`` fill a gap only; ``unit_count`` and ``property_type`` always win.",
"properties": {
"baths": {
"anyOf": [
{
"maximum": 20,
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"default": null
},
"beds": {
"anyOf": [
{
"maximum": 20,
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"default": null
},
"property_type": {
"anyOf": [
{
"enum": [
"single_family",
"condo",
"coop",
"multi_family"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"sqft": {
"anyOf": [
{
"maximum": 50000,
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
],
"default": null
},
"unit_count": {
"anyOf": [
{
"maximum": 50,
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
],
"default": null
},
"year_built": {
"anyOf": [
{
"maximum": 2027,
"minimum": 1700,
"type": "integer"
},
{
"type": "null"
}
],
"default": null
}
},
"type": "object"
},
"V1PreviousSale": {
"additionalProperties": false,
"properties": {
"arms_length": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null
},
"date": {
"format": "date",
"type": "string"
},
"price": {
"maximum": 100000000,
"minimum": 1,
"type": "number"
}
},
"required": [
"price",
"date"
],
"type": "object"
}
},
"additionalProperties": false,
"title": "V1AnalyzeRequest"
}