# Care Plan

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

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

#### Example Response `200 OK`

```json
{
  "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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.welkinhealth.com/developer-and-integration-guide/api-reference/care-plan.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.