Skip to main content

clinik.accounts

Accounts track billing and financial information — patient accounts, insurance coverage, guarantors, and service periods.

create

const { data, meta } = await clinik.accounts.create(request): Promise<ApiResponse<Account>>
FieldTypeRequiredDescription
statusstringYesactive, inactive, on-hold
typestringNoAccount type (patient, expense, depreciation)
namestringNoHuman-readable label
patientIdstringNoPatient the account is for
servicePeriod{ start?, end? }NoTransaction window
coverageArray<{ coverageId, priority? }>NoInsurance coverage
ownerIdstringNoOrganization managing the account
descriptionstringNoExplanation of purpose
guarantorArray<{ partyId, onHold?, period? }>NoResponsible parties
partOfIdstringNoParent account ID

Example

const { data } = await clinik.accounts.create({
  status: 'active',
  type: 'patient',
  name: 'Jane Doe - Primary Account',
  patientId: 'pt_abc123',
  servicePeriod: { start: '2025-01-01', end: '2025-12-31' },
  coverage: [{ coverageId: 'cov_insurance_001', priority: 1 }],
  ownerId: 'org_sunrise_medical',
});
Same pattern as other resources. Search supports patientId, status, type, ownerId filters.