---
title: "Update valuation"
method: PATCH
path: "/cases/{case_id}/real-estate-valuations/{valuation_id}"
tags: ["Real Estate Valuations"]
---

# Update valuation

`PATCH /cases/{case_id}/real-estate-valuations/{valuation_id}`

## Request

- Base URL: `https://api.example.com/v1`
- URL: `https://api.example.com/v1/cases/{case_id}/real-estate-valuations/{valuation_id}`
- Auth: none declared

Update property details, mortgage balance, or notes on a valuation. The equity estimate is recalculated automatically when mortgage balance changes.

## Request body

- object
  - `property_type` 'single_family' | 'multi_family' | 'condo' | 'townhouse' | 'mobile_home' | 'vacant_land' | 'commercial' | 'farm_ranch' | 'mixed_use' | 'other'
  - `mortgage_balance` number, double
  - `notes` string
  - `liens` object[]
    - `lien_type` 'mortgage' | 'home_equity' | 'tax_lien' | 'mechanics_lien' | 'judgment_lien' | 'hoa_lien' | 'other'
    - `holder` string
    - `amount` number, double
    - `recorded_date` string, date

## Response `200`

Valuation updated.

- object
  - `data` RealEstateValuation
    - `id` string
    - `financial_account_id` string: Reference to the financial account of type 'property'.
    - `property_address` Address
      - `address1` string
      - `address2` string, nullable
      - `city` string
      - `state` string
      - `zip` string
    - `property_type` 'single_family' | 'multi_family' | 'condo' | 'townhouse' | 'mobile_home' | 'vacant_land' | 'commercial' | 'farm_ranch' | 'mixed_use' | 'other'
    - `estimated_value` number, double, nullable: Current estimated market value.
    - `valuation_source` 'automated_avm' | 'county_assessor' | 'appraisal' | 'comparative_market_analysis' | 'owner_estimate' | 'tax_assessment': How the value was determined.
    - `valuation_date` string, date, nullable: Date the valuation was performed.
    - `confidence_score` number, double, nullable: Confidence score of the valuation (0.0 to 1.0). Only available for automated valuations.
    - `tax_assessed_value` number, double, nullable: County tax assessed value.
    - `tax_year` integer, nullable
    - `annual_property_tax` number, double, nullable
    - `lot_size_sqft` number, double, nullable
    - `living_area_sqft` number, double, nullable
    - `bedrooms` integer, nullable
    - `bathrooms` number, double, nullable: Full and half baths (e.g., 2.5).
    - `year_built` integer, nullable
    - `parcel_number` string, nullable: County parcel/APN number.
    - `zoning` string, nullable
    - `mortgage_balance` number, double, nullable: Outstanding mortgage balance, if known.
    - `equity_estimate` number, double, nullable: Estimated equity (estimated_value - mortgage_balance).
    - `liens` object[]
      - `lien_type` 'mortgage' | 'home_equity' | 'tax_lien' | 'mechanics_lien' | 'judgment_lien' | 'hoa_lien' | 'other'
      - `holder` string
      - `amount` number, double
      - `recorded_date` string, date, nullable
    - `comparable_sales` object[]: Recent comparable property sales used in the valuation.
      - `address` string
      - `sale_price` number, double
      - `sale_date` string, date
      - `living_area_sqft` number, double
      - `distance_miles` number, double
    - `status` 'pending' | 'completed' | 'failed' | 'stale': Valuation status. 'stale' indicates the valuation is older than 90 days.
    - `notes` string, nullable
    - `created_at` string, date-time
    - `updated_at` string, date-time

## Other responses

- `403`: Insufficient permissions for this case or resource.
- `404`: Resource not found.
- `422`: Request validation failed.

---

[API](https://skmtc.dev/hellosunset/apis/sunset-api.md) - [All operations](https://skmtc.dev/hellosunset/apis/sunset-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hellosunset/apis/sunset-api/revisions/f128e5526efe?raw)