---
title: "Change Matter Status"
method: POST
path: "/v1/matters/{matter_id}/details/status"
tags: ["matter-details"]
---

# Change Matter Status

`POST /v1/matters/{matter_id}/details/status`

## Request

- Base URL: `https://api.ender.au` (the document declares no server; this is the origin it was published from)
- URL: `https://api.ender.au/v1/matters/{matter_id}/details/status`
- Auth: HTTP bearer

## Path parameters

- `matter_id` string, uuid, required

## Request body

- MatterStatusCommand
  - `expected_version` integer, required
  - `status` 'active' | 'on_hold' | 'completed', required

## Response `200`

Successful Response

- MatterDetailsResponse
  - `matter_id` string, uuid, required
  - `workspace_id` string, uuid, required
  - `version` integer, required
  - `matter_type` 'corporate' | 'bankruptcy', required
  - `status` 'active' | 'on_hold' | 'completed' | 'archived', required
  - `name` string, required
  - `matter_code` string, required
  - `entity_acn` string, nullable, required
  - `entity_name` string, nullable, required
  - `entity_abn` string, nullable, required
  - `appointment_type` string, nullable, required
  - `appointment_date` string, date, nullable, required
  - `details` union, required
    - CorporateMatterDetails
      - `kind` 'corporate', required
      - `bas_frequency` 'monthly' | 'quarterly' | 'annually' | 'not_registered', nullable, required
      - `registered_address` MatterAddressOutput, required
        - `line_1` string, required
        - `line_2` string, nullable, required
        - `suburb` string, required
        - `state` string, required
        - `postcode` string, required
        - `country` string, required
      - `service_address` MatterAddressOutput, required
        - `line_1` string, required
        - `line_2` string, nullable, required
        - `suburb` string, required
        - `state` string, required
        - `postcode` string, required
        - `country` string, required
      - `date_of_insolvency` string, date, nullable, required
      - `acted_as_trustee` boolean, nullable, required
      - `pooling_applies` boolean, nullable, required
    - BankruptcyMatterDetails: Stored details, read as stored: the contact email is not re-validated.
      - `kind` 'bankruptcy', required
      - `first_name` string, nullable, required
      - `middle_names` string, nullable, required
      - `last_name` string, nullable, required
      - `former_name` string, nullable, required
      - `afsa_administration_number` string, nullable, required
      - `contact_email` string, nullable, required
      - `contact_phone` string, nullable, required
      - `debtor_abn` string, nullable, required
      - `employer_name` string, nullable, required
      - `dependant_count` integer, nullable, required
      - `bankruptcy_path` 'debtors_petition' | 'sequestration_order' | 'debt_agreement', nullable, required
      - `petitioning_creditor` string, nullable, required
      - `court_order_reference` string, nullable, required
      - `date_of_bankruptcy` string, date, nullable, required
      - `soa_lodgement_date` string, date, nullable, required
      - `estate_finalised_date` string, date, nullable, required
      - `sensitive` SensitiveBankruptcyDetailsOutput, required
        - `date_of_birth` string, date, nullable, required
        - `residential_address` MatterAddressOutput, required
          - `line_1` string, required
          - `line_2` string, nullable, required
          - `suburb` string, required
          - `state` string, required
          - `postcode` string, required
          - `country` string, required
        - `real_property_address` MatterAddressOutput, required
          - `line_1` string, required
          - `line_2` string, nullable, required
          - `suburb` string, required
          - `state` string, required
          - `postcode` string, required
          - `country` string, required
  - `can_edit` boolean, required
  - `can_close` boolean, required
  - `archived_at` string, date-time, nullable, required
  - `updated_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/ender/apis/ender-backend.md) - [All operations](https://skmtc.dev/ender/apis/ender-backend/llms.txt) - [OpenAPI document](https://skmtc.dev/ender/apis/ender-backend/revisions/a5849ac366ca?raw)