---
title: "Update unclaimed property"
method: PATCH
path: "/cases/{case_id}/unclaimed-property/{property_id}"
tags: ["Unclaimed Property"]
---

# Update unclaimed property

`PATCH /cases/{case_id}/unclaimed-property/{property_id}`

## Request

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

## Request body

- UnclaimedPropertyWrite
  - `property_type` 'dormant_bank_account' | 'uncashed_check' | 'insurance_proceeds' | 'utility_deposit' | 'rental_deposit' | 'safe_deposit_box' | 'stocks_bonds' | 'retirement_account' | 'gift_card' | 'insurance_refund' | 'mineral_rights' | 'wages' | 'refund' | 'other', required
  - `holder_name` string
  - `state` string, required
  - `reported_amount` number, double
  - `property_description` string
  - `owner_name_on_record` string
  - `claim_url` string
  - `claim_status` 'discovered' | 'claim_filed' | 'under_review' | 'approved' | 'paid' | 'denied' | 'expired'
  - `required_documents` string[]
  - `document_ids` string[]
  - `notes` string

## Response `200`

Record updated.

- object
  - `data` UnclaimedProperty
    - `id` string
    - `case_id` string
    - `property_type` 'dormant_bank_account' | 'uncashed_check' | 'insurance_proceeds' | 'utility_deposit' | 'rental_deposit' | 'safe_deposit_box' | 'stocks_bonds' | 'retirement_account' | 'gift_card' | 'insurance_refund' | 'mineral_rights' | 'wages' | 'refund' | 'other'
    - `holder_name` string, nullable: Institution or entity holding the property.
    - `state` string: US state where the property is held.
    - `reported_amount` number, double, nullable
    - `property_description` string, nullable
    - `owner_name_on_record` string, nullable: Name as it appears in the unclaimed property database.
    - `claim_status` 'discovered' | 'claim_filed' | 'under_review' | 'approved' | 'paid' | 'denied' | 'expired'
    - `claim_url` string, nullable: Direct link to the state claim portal.
    - `claim_filed_date` string, date, nullable
    - `claim_approved_date` string, date, nullable
    - `claim_paid_amount` number, double, nullable
    - `required_documents` string[]: Documents required to file the claim.
    - `document_ids` string[]: Case document IDs submitted with the claim.
    - `notes` string, nullable
    - `created_at` string, date-time
    - `updated_at` string, date-time

## Other responses

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