---
title: "List properties"
method: GET
path: "/cases/{case_id}/properties"
tags: ["Real Estate Properties"]
---

# List properties

`GET /cases/{case_id}/properties`

## Request

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

## Query parameters

- `page` integer
- `per_page` integer
- `property_type` 'primary_residence' | 'vacation_home' | 'investment_property' | 'rental_property' | 'vacant_land' | 'commercial' | 'farm_ranch' | 'mixed_use' | 'other'
- `status` 'owned' | 'pending_transfer' | 'listed_for_sale' | 'sold' | 'transferred' | 'in_probate' | 'unknown'

## Response `200`

List of properties.

- object
  - `data` RealEstateProperty[]
    - `id` string
    - `case_id` string
    - `property_type` 'primary_residence' | 'vacation_home' | 'investment_property' | 'rental_property' | 'vacant_land' | 'commercial' | 'farm_ranch' | 'mixed_use' | 'other'
    - `address` Address
      - `address1` string
      - `address2` string, nullable
      - `city` string
      - `state` string
      - `zip` string
    - `ownership_type` 'sole_ownership' | 'joint_tenancy' | 'tenants_in_common' | 'community_property' | 'transfer_on_death_deed' | 'lady_bird_deed' | 'trust' | 'life_estate' | 'other'
    - `title_vesting` string, nullable: How the title is vested.
    - `co_owners` object[]
      - `name` string
      - `relationship` string
      - `ownership_share` number, double, nullable
    - `estimated_value` number, double, nullable
    - `assessed_value` number, double, nullable
    - `outstanding_mortgage` number, double, nullable
    - `mortgage_holder` string, nullable
    - `equity_estimate` number, double, nullable
    - `liens` object[]
      - `lien_type` 'mortgage' | 'heloc' | 'tax_lien' | 'mechanics_lien' | 'judgment_lien' | 'hoa_lien' | 'other'
      - `holder` string
      - `amount` number, double
      - `recorded_date` string, date, nullable
    - `annual_property_tax` number, double, nullable
    - `parcel_number` string, nullable
    - `deed_type` 'warranty' | 'quitclaim' | 'grant' | 'special_warranty' | 'transfer_on_death' | 'lady_bird' | 'null', nullable
    - `rental_income` number, double, nullable: Monthly rental income if property is rented.
    - `is_homestead` boolean: Whether the property qualifies as a homestead for exemption purposes.
    - `requires_probate` boolean: Whether the property must go through probate (based on ownership type).
    - `status` 'owned' | 'pending_transfer' | 'listed_for_sale' | 'sold' | 'transferred' | 'in_probate' | 'unknown'
    - `valuation_id` string, nullable: Link to a real estate valuation record.
    - `institution_contact_id` string, nullable
    - `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)