--- title: "The board. `status` defaults to `Active` — who is in the hospital now. Each entry carries the stay, the patient projection, and the full sheet, so the rail, the care board and the handoff view all render from one round trip." method: GET path: "/hospitalstays/board" tags: ["HospitalStays"] --- # The board. \`status\` defaults to \`Active\` — who is in the hospital now. Each entry carries the stay, the patient projection, and the full sheet, so the rail, the care board and the handoff view all render from one round trip. `GET /hospitalstays/board` ## Request - Base URL: `https://api.clinicos.vet/backend/business` - URL: `https://api.clinicos.vet/backend/business/hospitalstays/board` - Auth: HTTP bearer ## Query parameters - `status` string ## Response `200` OK - TreatmentBoardDto: The whole hospitalization board. One round trip feeds the patient rail, the care board and the handoff view. - `entries` TreatmentBoardEntryDto[] - `stay` HospitalStayDto: The stay header. Billing state is not on this record by design — string? HospitalStayDto.EstimateId points at the stay's running estimate and the estimate is the authority for what has been charged. - `id` string - `patientId` string - `clientId` string - `appointmentId` string, nullable - `caseId` string, nullable - `locationId` string, nullable - `locationName` string, nullable - `attendingUserId` string, nullable - `attendingName` string, nullable - `assignedUserIds` string[]: Assigned nurse/tech crew, parallel to List<string> HospitalStayDto.AssignedNames. - `assignedNames` string[] - `acuity` 'stable' | 'watch' | 'critical': How sick the patient is right now — drives board sort and colour, not clinical logic. - `status` 'Active' | 'Discharged' | 'Closed': Lifecycle of a `HospitalStay`. Discharged means the patient has physically left; Closed means the stay's paperwork (billing, discharge doc) is finished and it should drop off the board entirely. - `admittedAt` string, date-time - `dischargedAt` string, date-time, nullable - `closedAt` string, date-time, nullable - `estimateId` string, nullable - `reasonForStay` string, nullable - `note` string, nullable - `createdAt` string, date-time - `updatedAt` string, date-time - `authorization` TreatmentAuthorizationDto: The authorization rail: what the client approved, what has been charged, what the schedule says is still coming. Shape mirrors `TreatmentAuthorization` in the web treatment view models. Amounts are 2dp, rounded half away from zero to match the Postgres numeric(10,2) convention the estimate itself is stored in. - `approvedMin` union: Low end of the range the client accepted; null until the estimate is accepted. - number, double - string, double - `approvedMax` union: High end of the range the client accepted; null until the estimate is accepted. - number, double - string, double - `deliveredAmount` union: Value of Performed estimate lines captured from this stay's completed occurrences. - number, double - string, double - `projectedAmount` union: decimal TreatmentAuthorizationDto.DeliveredAmount plus unit price × expected remaining occurrences of every active billable order — derived from the schedule, not counted from lines. - number, double - string, double - `unapprovedAmount` union: Value of estimate lines the client has not approved (added after the last acceptance, or never accepted). - number, double - string, double - `currency` string: ISO 4217 code from the clinic's region settings ("USD" / "GBP"). - `patient` TreatmentBoardPatientDto: Patient header shown on every board card and on the patient rail. - `id` string - `name` string - `species` string, nullable - `breed` string, nullable - `sex` string, nullable - `ageDisplay` string, nullable: "3y 2m" style, computed from the date of birth on the server clock. - `dateOfBirth` string, date-time, nullable - `weightKg` union: Current weight for dose calculation, in kilograms rounded to 2 dp. Sourced from the patient's most recent `VitalMeasurement` (by `TakenAt`) whose type is the "weight" vital: the free-text value is parsed and converted from the type's unit (or a unit suffix in the value) by `WeightKilograms`. Null when the patient has no weight vital, or the latest one cannot be read as a weight. - number, double - string, double - `weightTakenAt` string, date-time, nullable: When decimal? TreatmentBoardPatientDto.WeightKg was taken, so the UI can flag a stale weight. Null with it. - `photoUrl` string, nullable: Profile photo. Not populated yet — presigning it needs `IFileStorageService`, which the Business API test suite mocks, so it is deliberately left to the web slice. - `clientName` string, nullable - `orders` TreatmentOrderDto[] - `id` string - `stayId` string - `kind` 'medication' | 'fluid' | 'diagnostic' | 'monitoring' | 'procedure' | 'nursing' | 'nutrition' | 'communication' | 'task': What kind of thing a treatment order is. Mirrors the prototype's `TreatmentOrderKind` so the web mirror can map one-to-one. - `title` string - `subtitle` string, nullable - `state` 'active' | 'held' | 'discontinued' | 'completed': Workflow state of an order. Completed is reached when the schedule runs out (or every occurrence is resolved); Discontinued is a clinician stopping it early. Both are terminal — an order is never hard-deleted, so the audit trail survives. - `priority` 'routine' | 'important' | 'critical': Clinical urgency of an order. Distinct from Priority, which is a task concept. - `scheduleType` 'once' | 'interval' | 'times' | 'continuous' | 'prn': How an order recurs. The occurrence rows themselves are materialized by the scheduling engine (ITE-701); this enum is only the declaration of intent. - `scheduleLabel` string, nullable - `intervalMinutes` union - integer - string, int32 - `startAt` string, date-time, nullable - `endAt` string, date-time, nullable - `times` string[]: Explicit due times for `times` schedules, stored exactly as the client sent them. - `maxOccurrences` union - integer - string, int32 - `medication` TreatmentMedicationDetailsDto: Medication dosing detail. Every field optional — see the entity's landmine note. - `drug` string, nullable - `dose` union - number, double - string, double - `doseUnit` string, nullable - `calculatedDose` union - number, double - string, double - `calculatedDoseUnit` string, nullable - `concentration` union - number, double - string, double - `concentrationUnit` string, nullable - `calculatedVolumeMl` union - number, double - string, double - `route` string, nullable - `maxDose` union - number, double - string, double - `fluid` TreatmentFluidDetailsDto: Fluid-therapy detail. Every field optional — see the entity's landmine note. - `fluid` string, nullable - `rateMlHr` union - number, double - string, double - `bolusMlKg` union - number, double - string, double - `calculatedBolusMl` union - number, double - string, double - `additives` string[], nullable - `instructions` string, nullable - `resultUnit` string, nullable - `serviceCatalogItemId` string, nullable - `inventoryItemId` string, nullable - `billableItemId` string, nullable - `createdBy` string: Display name of the author; falls back to the user id, never null. - `createdById` string, nullable - `createdAt` string, date-time - `updatedAt` string, date-time - `heldAt` string, date-time, nullable - `discontinuedAt` string, date-time, nullable - `completedAt` string, date-time, nullable - `occurrences` TreatmentOccurrenceDto[] - `id` string - `orderId` string - `dueAt` string, date-time - `status` 'pending' | 'completed' | 'skipped' | 'held': State of one scheduled slot of an order. - `kind` 'clinical' | 'billing': What an occurrence row stands for. The Now view, the care board and the awareness engine only ever look at TreatmentOccurrenceKind.Clinical rows; TreatmentOccurrenceKind.Billing rows are the daily charge cadence for continuous orders (ITE-735) and must never surface as nursing work. - `completedAt` string, date-time, nullable - `completedById` string, nullable - `completedBy` string, nullable - `actualValue` string, nullable - `note` string, nullable - `skippedReason` string, nullable - `heldAt` string, date-time, nullable - `occurrenceKey` string - `estimateLineItemId` string, nullable: The estimate line this completion was charged as (ITE-703); null when nothing was captured. - `events` TreatmentOrderEventDto[]: The append-only audit trail, oldest first. - `id` string - `orderId` string - `occurrenceId` string, nullable - `action` 'created' | 'edited' | 'completed' | 'skipped' | 'held' | 'resumed' | 'discontinued' | 'delayed' | 'charge_captured' | 'charge_capture_failed': Append-only audit actions on the treatment-order trail, mirroring MedicationRequestEventType for the medication-request trail. - `at` string, date-time - `actor` string - `actorUserId` string, nullable - `detail` string, nullable - `lastSeenAt` string, date-time, nullable: The caller's "last looked at this sheet" marker (ITE-704), or null when they have never looked. Per user: two people reading the same board get different values. - `changedSinceLastSeen` union: Audit events on this stay's orders after DateTime? TreatmentBoardEntryDto.LastSeenAt; 0 when there is no marker. - integer - string, int32 - `timestamp` string, date-time ## Other responses - `400`: Bad Request ## Changes - **2026-09-11** `503cd0546309`: 1 info - endpoint added [Operation history](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/changes/hospitalstays/board/get.md) --- [API](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1.md) - [All operations](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/revisions/099cf36186e0?raw)