Admissions

warning

Satxuma is still under active development. It is not yet HIPAA compliant and should only be used with dummy data.

An admission represents a patient’s stay at a facility during which care is provided and billing periods are tracked. It ties together the patient, the facility, and the time period of the stay.

Admissions provide the structural backbone for organizing billing periods, which define how services are billed.

---

Data model

Satxuma stores admissions under a patient while also linking them to a facility:

Multiple therapy cases may reference the same admission

Furthermore, an admission may store a collection of billing periods used to specify which payors are responsible for covering therapy services tied to the admission.

Properties

• billingPeriods (BillingPeriod[]) — List of billing periods within this admission.
• endUTC (Timestamp | Date | null) — End date/time of the admission, or null if ongoing.
• facility ({ id: string; name: string; stateId: StateId; timeZone: TimeZone; type: FacilityType }) — Facility details for the admission.
• medicalRecordNumber (string) — The facility’s identifier for the patient’s admission (often MRN).
• notes (string) — Free-text notes about the admission.
• roomNumber (string) — Patient’s assigned room.
• startUTC (Timestamp | Date) — Start date/time of the admission.

Examples

Example 1

{
  "billingPeriods": [],
  "endUTC": "2025-01-15T10:30:00Z",
  "facility": {
    "id": "f001",
    "name": "Pine Nursing",
    "stateId": "TX",
    "timeZone": "America/Chicago",
    "type": "Skilled nursing"
  },
  "medicalRecordNumber": "MRN-1001",
  "notes": "Post-op recovery following knee replacement",
  "roomNumber": "104B",
  "startUTC": "2025-01-01T09:00:00Z"
}

Example 2

{
  "billingPeriods": [],
  "endUTC": null,
  "facility": {
    "id": "f002",
    "name": "Oak Rehab",
    "stateId": "CA",
    "timeZone": "America/Los_Angeles",
    "type": "Inpatient rehab"
  },
  "medicalRecordNumber": "MRN-2002",
  "notes": "Patient admitted for stroke rehabilitation; ongoing",
  "roomNumber": "212",
  "startUTC": "2025-03-05T10:00:00Z"
}

Example 3

{
  "billingPeriods": [],
  "endUTC": "2025-02-20T11:00:00Z",
  "facility": {
    "id": "f003",
    "name": "Maple Hospital",
    "stateId": "NY",
    "timeZone": "America/New_York",
    "type": "Hospital"
  },
  "medicalRecordNumber": "MRN-3003",
  "notes": "Short-term inpatient stay for observation and testing",
  "roomNumber": "3E",
  "startUTC": "2025-02-10T17:45:00Z"
}