---
title: "Update business"
method: PATCH
path: "/cases/{case_id}/businesses/{business_id}"
tags: ["Business Ownership"]
---

# Update business

`PATCH /cases/{case_id}/businesses/{business_id}`

## Request

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

## Request body

- BusinessOwnershipWrite
  - `entity_type` 'c_corp' | 's_corp' | 'llc' | 'general_partnership' | 'limited_partnership' | 'sole_proprietorship' | 'dba_trade_name' | 'franchise' | 'professional_license' | 'nonprofit' | 'other', required
  - `business_name` string, required
  - `state_of_formation` string
  - `ein` string: Full EIN.
  - `status` 'active' | 'inactive' | 'dissolved' | 'merged' | 'suspended' | 'unknown'
  - `deceased_role` 'sole_owner' | 'majority_owner' | 'minority_owner' | 'partner' | 'officer' | 'director' | 'shareholder' | 'member' | 'manager' | 'license_holder' | 'other'
  - `ownership_percentage` number, double
  - `estimated_value` number, double
  - `co_owners` object[]
    - `name` string
    - `role` string
    - `ownership_percentage` number, double
  - `has_operating_agreement` boolean
  - `has_buy_sell_agreement` boolean
  - `succession_plan` 'sell' | 'transfer_to_heir' | 'dissolve' | 'continue_with_partners' | 'pending_decision'
  - `registered_agent` string
  - `institution_contact_id` string
  - `notes` string

## Response `200`

Business updated.

- object
  - `data` BusinessOwnership
    - `id` string
    - `case_id` string
    - `entity_type` 'c_corp' | 's_corp' | 'llc' | 'general_partnership' | 'limited_partnership' | 'sole_proprietorship' | 'dba_trade_name' | 'franchise' | 'professional_license' | 'nonprofit' | 'other'
    - `business_name` string
    - `state_of_formation` string, nullable
    - `ein` string, nullable: Employer Identification Number. Masked in responses.
    - `status` 'active' | 'inactive' | 'dissolved' | 'merged' | 'suspended' | 'unknown'
    - `deceased_role` 'sole_owner' | 'majority_owner' | 'minority_owner' | 'partner' | 'officer' | 'director' | 'shareholder' | 'member' | 'manager' | 'license_holder' | 'other'
    - `ownership_percentage` number, double, nullable: Deceased's ownership share as a percentage.
    - `estimated_value` number, double, nullable: Estimated value of the deceased's interest.
    - `co_owners` object[]
      - `name` string
      - `role` string
      - `ownership_percentage` number, double
    - `has_operating_agreement` boolean: Whether an operating agreement or bylaws exist.
    - `has_buy_sell_agreement` boolean: Whether a buy-sell agreement exists.
    - `succession_plan` 'sell' | 'transfer_to_heir' | 'dissolve' | 'continue_with_partners' | 'pending_decision' | 'null', nullable
    - `professional_licenses` object[]
      - `license_type` string
      - `license_number` string
      - `issuing_state` string
      - `expiration_date` string, date, nullable
      - `status` 'active' | 'expired' | 'suspended' | 'revoked'
    - `registered_agent` string, nullable
    - `annual_revenue` number, double, nullable
    - `employees` integer, nullable
    - `institution_contact_id` string, nullable
    - `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)