Care Plan

Read patient care plans and associated goals.

Care Plans represent structured treatment plans assigned to patients in Welkin, including goals, phases, and progress tracking.

Base path: /{tenantName}/{instanceName}/patients/{patientId}/care-plan

---

Endpoints

GET Get Care Plan by Patient ID

GET /{tenantName}/{instanceName}/patients/{patientId}/care-plan

Returns the active care plan for a patient, including all assigned goals and their statuses.

Path Parameters

Parameter	Type	Required	Description
patientId	string	Yes	Welkin patient UUID

Example Request

GET /acme-health/live/patients/a1b2c3d4/care-plan
Authorization: Bearer <token>

Example Response 200 OK

{
  "id": "careplan-uuid",
  "patientId": "a1b2c3d4",
  "status": "ACTIVE",
  "startDate": "2026-01-15",
  "goals": [
    {
      "id": "goal-uuid-1",
      "title": "Reduce A1C to below 7%",
      "status": "IN_PROGRESS",
      "targetDate": "2026-06-30",
      "progressNotes": "Patient reports diet improvements."
    },
    {
      "id": "goal-uuid-2",
      "title": "Daily blood pressure monitoring",
      "status": "COMPLETED",
      "targetDate": "2026-03-01"
    }
  ],
  "updatedAt": "2026-03-15T08:00:00Z"
}

---

Goals

Goals are individual milestones within a care plan. They can be tracked with completion status, target dates, and progress notes.

GET Get All Goals

GET /{tenantName}/{instanceName}/patients/{patientId}/care-plan/goals

GET Get Goal by ID

GET /{tenantName}/{instanceName}/patients/{patientId}/care-plan/goals/{goalId}

POST Create Goal

POST /{tenantName}/{instanceName}/patients/{patientId}/care-plan/goals

PATCH Update Goal

PATCH /{tenantName}/{instanceName}/patients/{patientId}/care-plan/goals/{goalId}

DELETE Delete Goal

DELETE /{tenantName}/{instanceName}/patients/{patientId}/care-plan/goals/{goalId}

---

Overview

GET Get Care Plan Overview

GET /{tenantName}/{instanceName}/patients/{patientId}/care-plan/overview

Returns a summary view of the care plan including goal completion rates and key milestones.