LUlumahealth
billingCharges

Create a fixed-amount billing charge

Changed on

Creates a fixed-amount charge associated with a patient and appointment using a caller-provided valid status. Payment status is managed separately and is not set by this endpoint.

post/billingCharges

Request

Request body

patientstring required

ID of the patient this charge is for.

appointmentstring required

ID of the appointment this charge is for.

amountnumber required

The charge amount. Must be zero or greater.

type'copay' | 'balance' | 'custom-appointment-charge' | 'convenience-fee' required

The kind of charge.

source'manual' | 'integrator' | 'insurance-verification' | 'ai-suggestions' | 'fixedAmount' required

The source of the charge. Must be a valid ChargeSource value.

status'planned' | 'billable' | 'billed' | 'aborted' required

The lifecycle status of the charge.

Response

Successful creation

_idstring

Luma's internal ID of an object.

userstring

The ID of the root account user.

deleted0 | 1

Flag for logical deletion where 1 means deleted.

createdBystring

The ID of the user who created this object.

updatedBystring

The ID of the user who updated this object.

createdAtstring date-time

The date/time when this object was created.

updatedAtstring date-time

The date/time when this object was updated.

amountnumber

The charge amount.

currencystring

Currency code for the charge.

status'planned' | 'billable' | 'billed' | 'aborted'

Lifecycle status of the charge. planned = planned but not yet billed, billable = confirmed by staff and ready to bill, billed = sent to the patient for collection, aborted = wrongfully added or aborted.

lastStatusUpdatedAtstring date-time

When status was last changed.

lastStatusUpdatedBystring

ID of the user who last changed status.

type'copay' | 'balance' | 'custom-appointment-charge' | 'convenience-fee'

The kind of charge. copay = copay amount for the appointment, balance = patient balance tied to the appointment, custom-appointment-charge = custom value added by staff, convenience-fee = a convenience fee charge.

source'manual' | 'integrator' | 'insurance-verification' | 'fixedAmount'

Where the charge originated from. manual = added by staff, integrator = from the EHR, insurance-verification = from the insurance verification process, fixedAmount = created from a fixed copay rule.

descriptionstring

Public description of the charge, visible to the patient.

reasonstring

Internal, staff-only note about the charge. Omitted from patient-facing responses.

appointmentstring

ID of the appointment associated with this charge.

patientstring

ID of the patient associated with this charge.

insuranceVerificationstring

ID of the insurance verification this charge's copay was derived from, if any.

insurancestring

ID of the patient's insurance saved alongside the insurance verification.

paymentStatus'pending' | 'not-paid' | 'paid' | 'partially-paid' | 'refunded'

How much of the charge has been collected.

amountPaidnumber

The amount paid toward this charge so far.

billingTransactionsstring[]

IDs of the billing transactions associated with this charge.

isCreatedByAIboolean

Indicates whether this charge was created or suggested by AI.

hasDiscountboolean

Whether a prompt-pay discount was actually honoured (money captured under it) for this charge. false for a discount that was only ever offered but never paid.

Changes