CareTend API Release Notes - 4/6/2026 - 4/17/2026

Issue Number

Jira Number

Release Note

Collection

API Version

Availability

WSI-66548

HCSI-4953

Updated the POST /v4/deliverytickets/items endpoint to accept LocationId as an optional input parameter alongside required fields such as InventoryItemId, allowing clients to specify the inventory location when adding items to a delivery ticket. Previously, the endpoint did not add the Location_Id to the database. The endpoint now correctly stores and returns the LocationId for delivery ticket items in the response.

Deivery
Tickets

V4

Staging:
4/22/2026

Production:
4/22/2026

N/A

HCSI-4954

Enhanced the PATCH /v4/deliverytickets/items/{id} endpoint to accept an optional LocationId field, allowing external systems to update the inventory location on a delivery ticket item without requiring manual entry in CareTend. On success, the API returns the updated ticket item with the correct location assignment.

Delivery
Tickets

V4

Staging:
4/22/2026

Production:
4/22/2026

N/A

HCSI-5459

Added a POST /v4/supporting-documents endpoint to create Statement of Medical Necessity (SMN) documents for patients, accepting document date, certification type, expiration date, diagnoses, clinical notes, modifiers, and field values with sensible defaults applied when optional fields are omitted. A companion GET /v4/supporting-documents/{id} endpoint retrieves the full SMN document by ID, enabling external systems to create and retrieve complete medical necessity documentation without manual CareTend Desktop entry.

Supporting Documents

V4

Staging:
4/22/2026

Production:
4/22/2026

N/A

HCSI-5429

Resolved an issue where the PATCH /v4/prescriptions/transfer endpoint returned 400 "Central Pharmacy must be enabled in order to transfer prescriptions" for all tenants regardless of their actual configuration, making prescription transfers impossible through the V4 API. The endpoint now correctly reads each tenant's Central Pharmacy configuration and completes transfers for tenants where the feature is enabled.

Prescriptions

V4

Staging:
4/22/2026

Production:
4/22/2026

N/A

HCSI-5433

Resolved an issue where the PATCH /v4/clinicianvisits/{id} endpoint accepted empty strings for mandatory fields TherapyType, EmployeeUserName, PatientMRN, and InventoryItemId and returned HTTP 200 without validation errors, allowing incomplete records to be saved in violation of CareTend business rules. The endpoint now returns 400 Bad Request with field-specific error messages when mandatory fields are submitted as empty.

Clinician
Visits

V4

Staging:
4/22/2026

Production:
4/22/2026

N/A

HCSI-5435

Resolved an issue where the PATCH /v4/billingauthorizations/{id} endpoint returned 404 when attempting to reactivate a discontinued billing authorization, even though CareTend Desktop permitted this workflow. Added an includeInactive=true query parameter that allows discontinued authorizations to be located and updated, enabling full authorization lifecycle management through the API.

Billing
Auths

V4

Staging:
4/22/2026

Production:
4/22/2026

N/A

HCSI-5436

Resolved an issue where the PATCH /v4/patients/mrn/{mrn}/patientalerts endpoint returned 500 Internal Server Error instead of 404 when no alert record existed for a patient, and corrected the related GET endpoint which returned 400 instead of 404. Both endpoints now return 404 with consistent error messages, allowing external systems to reliably distinguish between missing patients and missing alert records.

Patients

V4

Staging:
4/22/2026

Production:
4/22/2026

N/A

HCSI-5438

Resolved an issue where the PATCH /v4/deliverytickets/{id} endpoint silently cleared the TrackingURL and Delivery Manager (IsVirtueScriptEnabled) settings whenever the shipping method was changed, despite returning a 200 OK response. On success, shipping method updates preserve all associated configuration including Tracking URL and Delivery Manager settings.

Delivery
Tickets

V4

Staging:
4/22/2026

Production:
4/22/2026

N/A

HCSI-5459

Added a POST /v4/patients/assessments/custom endpoint to create custom assessment instances for patients in CareTend, accepting MedicalRecordNumber and ContainerGroupId (template ID) as required fields along with optional clinician, date, status, location, and assessment type. On success, the API returns the CustomAssessmentId and PatientAssessmentId needed to complete the assessment via the field update endpoint, enabling end-to-end custom assessment workflows without CareTend Desktop interaction.

Custom
Assessments

V4

Staging:
4/22/2026

Production:
4/22/2026

N/A

HCSI-5460

Enhanced the POST /v4/customassessments/template endpoint to return ContainerId and FieldId values for all created groups and fields in the creation response, eliminating the need for a separate lookup call to discover these identifiers after template creation. External systems can now immediately use the returned identifiers to populate assessment instances without additional API calls.

Custom
Assessments

V4

Staging:
4/22/2026

Production:
4/22/2026

N/A

HCSI-5466

Resolved an issue where the POST /v4/inventory/items/quantity/deduct endpoint drew vial-based deductions from quantity-based inventory records instead of the correct vial-sized records, causing inaccurate inventory totals and erroneous "Insufficient quantity" errors. On success, the API deducts from the correct vial-size record, ensuring accurate inventory totals for pharmaceutical dispensing operations.

Inventory

V4

Staging:
4/22/2026

Production:
4/22/2026