---
title: "Creating a Medical Records Detail, Medical Records and Medical Bills"
method: POST
path: "/medical_records_details.json"
tags: ["Medical Records Details"]
---

# Creating a Medical Records Detail, Medical Records and Medical Bills

`POST /medical_records_details.json`

This endpoint allows a creation of a Medical Records Detail, multiple Medical Records and Medical Bills.
Medical Liens can also be created as a property under Medical Bills.

Reference the payload to see how the records are being passed in.

## Query parameters

- `fields` string

## Headers

- `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', required — Current status for the Medical Bills.
    - `description` string — Detailed description of the Medical Records Detail.
    - `in_treatment` boolean, required — True or false value to record if the treatment has been completed.
    - `matter_id` integer, required — The ID of the matter that the Medical Records Detail belongs to.
    - `medical_bills` object[]
      - `adjustment` number, double, required — Adjustment for Medical Bill.
      - `amount` number, double, required — Amount for Medical Bill.
      - `balance` number, double, required — 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, required — Name for Medical Bill.
      - `mark_balance_type_as` 'lien' | 'outstanding_balance' | 'neither', required — Mark balance as lien, outstanding balance, or neither
      - `payers` object[]
        - `amount` number, double, required — Lien amount.
        - `holder_id` integer, required — The unique identifier for a single Damage associated with the MedicalRecordsRequest. The keyword `null` is not valid for this field.
        - `mark_as_lien` boolean, required — Mark record as Lien.
    - `medical_provider_id` integer, required — The unique identifier for a single Medical Provider associated with this Medical Records Detail.
    - `medical_records` object[]
      - `document_id` integer, required — 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', required — 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 `201`

Created

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `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/revisions/73791ddd1207/schema)