---
title: "Updating a Medical Records Detail"
method: PATCH
path: "/medical_records_details/{id}.json"
tags: ["Medical Records Details"]
---

# Updating a Medical Records Detail

`PATCH /medical_records_details/{id}.json`

If there are records being passed into the Medical Records or Medical Bills parameter they will be treated
as new records and new Medical Records / Medical Bills will be created.

## Path parameters

- `id` integer, required

## Query parameters

- `fields` string

## Headers

- `IF-MATCH` string
- `X-API-VERSION` string

## Request body

- object
  - `data` object, required
    - `bills_follow_up_date` string, date-time — Follow up date for Medical Bills. (Expects an ISO-8601 date).
    - `bills_request_date` string, date-time — Requested date for Medical Bills. (Expects an ISO-8601 date).
    - `bills_status` 'not_yet_requested' | 'requested' | 'received' | 'incomplete' | 'certified' — Current status for the Medical Bills.
    - `description` string — Detailed description of the Medical Records Detail.
    - `in_treatment` boolean — True or false value to record if the treatment has been completed.
    - `medical_bills` object[]
      - `adjustment` number, double — Adjustment for Medical Bill.
      - `amount` number, double — Amount for Medical Bill.
      - `balance` number, double — Balance for Medical Bill.
      - `bill_date` string, date — Bill date for Medical Bill. (Expects an ISO-8601 date).
      - `bill_received_date` string, date — Bill received date for Medical Bill. (Expects an ISO-8601 date).
      - `document_id` integer — The unique identifier for a single Damage associated with the MedicalRecordsRequest. The keyword `null` is not valid for this field.
      - `name` string — Name for Medical Bill.
      - `mark_balance_type_as` 'lien' | 'outstanding_balance' | 'neither' — Mark balance as lien, outstanding balance, or neither
      - `payers` object[]
        - `amount` number, double — Lien amount.
        - `holder_id` integer — The unique identifier for a single Damage associated with the MedicalRecordsRequest. The keyword `null` is not valid for this field.
        - `mark_as_lien` boolean — Mark record as Lien.
    - `medical_provider_id` integer — The unique identifier for a single Medical Provider associated with this Medical Records Detail.
    - `medical_records` object[]
      - `document_id` integer — The unique identifier for a single MedicalRecord associated with the MedicalRecordsRequest. The keyword `null` is not valid for this field.
      - `end_date` string, date-time — End date for Medical Record.
      - `start_date` string, date-time — Start date for Medical Record.
    - `records_follow_up_date` string, date-time — Follow up date for Medical Records. (Expects an ISO-8601 date).
    - `records_request_date` string, date-time — Requested date for Medical Records. (Expects an ISO-8601 date).
    - `records_status` 'not_yet_requested' | 'requested' | 'received' | 'incomplete' | 'certified' — Current status for the Medical Records.
    - `treatment_end_date` string, date-time — End date for the treatment. (Expects an ISO-8601 date).
    - `treatment_start_date` string, date-time — Start date for the treatment. (Expects an ISO-8601 date).

## Response `200`

Ok

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `412` — Precondition Failed
- `422` — Unprocessable Entity
- `429` — Too Many Requests

---

[API](https://skmtc.net/clio/apis/clio-api-documentation.md) · [All operations](https://skmtc.net/clio/apis/clio-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clio/clio-api-documentation/versions/94a82114ec3b/schema)