Skip to main content

clinik.chargeItems

Charge Items represent billable services and charges, mapped to the FHIR ChargeItem resource.

create

const { data, meta } = await clinik.chargeItems.create(request): Promise<ApiResponse<ChargeItem>>
FieldTypeRequiredDescription
statusstringYesplanned, billable, not-billable, aborted, billed
codestring | CodeableConceptYesBilling code (CPT, HCPCS, etc.)
patientIdstringYesPatient ID
encounterIdstringNoEncounter context
occurrenceDateTimestringNoWhen the charge occurred
occurrencePeriod{ start?, end? }NoCharge time range
performerArrayNoPerformers
performingOrganizationIdstringNoPerforming organization
requestingOrganizationIdstringNoRequesting organization
quantity{ value, unit? }NoQuantity
bodySitestring[]NoBody sites
priceOverride{ value, currency? }NoPrice override
overrideReasonstringNoReason for price override
enteredDatestringNoWhen the charge was entered
reasonstring[]NoReason codes
accountIdsstring[]NoAccount IDs to charge
notestringNoAdditional notes

Performer Fields

FieldTypeRequiredDescription
functionstringNoPerformer function/role
actorIdstringYesPerformer reference

Example

const { data } = await clinik.chargeItems.create({
  status: 'billable',
  code: {
    system: 'http://www.ama-assn.org/go/cpt',
    code: '99213',
    display: 'Office visit, established patient',
  },
  patientId: 'pt_abc123',
  encounterId: 'enc_visit456',
  priceOverride: { value: 150.00, currency: 'USD' },
});
Same pattern as other resources. Search supports patientId, status, code, dateFrom, dateTo filters.