---
title: "List real estate valuations"
method: GET
path: "/cases/{case_id}/real-estate-valuations"
tags: ["Real Estate Valuations"]
---

# List real estate valuations

`GET /cases/{case_id}/real-estate-valuations`

## Request

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

List all property valuations for a case, including automated AVM results, tax assessments, and appraisal records.

## Query parameters

- `page` integer
- `per_page` integer
- `status` 'pending' | 'completed' | 'failed' | 'stale'
- `property_type` 'single_family' | 'multi_family' | 'condo' | 'townhouse' | 'mobile_home' | 'vacant_land' | 'commercial' | 'farm_ranch' | 'mixed_use' | 'other'

## Response `200`

List of valuations.

- 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
  - `meta` PaginationMeta
    - `page` integer
    - `per_page` integer
    - `total_count` integer
    - `total_pages` integer
    - `next_cursor` string, nullable: Opaque cursor for fetching the next page. Pass as the `cursor` query parameter. Null when on the last page.
    - `has_more` boolean: Whether more results exist beyond this page.

## Other responses

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

---

[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)