---
title: "List care plans"
method: GET
path: "/api/2026-01-01/medical-record/care-plans"
tags: ["CarePlans"]
---

# List care plans

`GET /api/2026-01-01/medical-record/care-plans`

## Request

- Base URL: `https://jdpdocsdemo.jane.qa`
- URL: `https://jdpdocsdemo.jane.qa/api/2026-01-01/medical-record/care-plans`
- Auth: OAuth 2
  - Authorization code: `https://login.id.janeapp.com/realms/jane_partner_sandbox/protocol/openid-connect/auth?response_type=code&resource=https://jdpdocsdemo.jane.qa&prompt=consent`
  - Token URL: `https://login.id.janeapp.com/realms/jane_partner_sandbox/protocol/openid-connect/token` scopes: `care_plans:read`

List medical record care plans for the current user's accessible patients.

## Query parameters

- `page[limit]` integer
- `page[cursor]` string
- `sort` string
- `patient_id[eq]` string, uuid
- `category[eq]` 'treatment_plan'
- `encounter_id[eq]` string, uuid

## Response `200`

List of care plans

- CarePlansResponse
  - `items` CarePlan[], required: Array of care plan objects
    - `id` string, uuid: UUIDv7 identifier for the care plan
    - `patient_id` string, uuid, required: Reference to the patient
    - `practitioner_id` string, uuid: Reference to the practitioner who performed/recorded the observation
    - `encounter_id` string, uuid: Reference to the encounter where the care plan was made
    - `category` 'treatment_plan', required: The classification of the type of care plan
    - `title` string: The title of the care plan
    - `description` string: The description of the care plan
    - `status` 'draft' | 'active' | 'on-hold' | 'revoked' | 'completed' | 'entered-in-error' | 'unknown': The status of the care plan
    - `created_at` string, date-time: When the care plan record was created
    - `updated_at` string, date-time: When the care plan record was updated
    - `activities` CarePlanActivity[]: Array of care plan activities
      - `id` string, uuid: UUIDv7 identifier for the component
      - `category` 'appointment' | 'exercise' | 'medication' | 'nutrition', required: The classification of the type of care plan activity
      - `description` string: The description of the care plan activity
      - `progress` string: The progress of the care plan activity
      - `created_at` string, date-time: When the care plan activity record was created
      - `updated_at` string, date-time: When the care plan activity record was updated
    - `document_ids` string[]: Array of document upload IDs to attach to the care plan. All documents must exist and be verified.
    - `documents` object[]: Array of document upload IDs currently attached to the care plan.
      - `id` string, uuid, required
  - `cursor` string, nullable: Cursor for fetching the next page of results
  - `limit` integer, required: Maximum number of items returned
  - `links` object
    - `before` string, nullable: URL for the previous page
    - `after` string, nullable: URL for the next page
  - `hasNextPage` boolean, required: Whether there are more items available

## Other responses

- `400`: Invalid request parameters
- `401`: Unauthenticated - missing or invalid credentials
- `403`: Forbidden - insufficient OAuth scope

## Changes

- **2026-11-03** `01798f613a5e`: 1 warning, 2 info
  - removed the optional property `object` from the response with the `400` status
  - added the optional property `items/items/documents` to the response with the `200` status
  - the response optional property `items/items/document_ids` became write-only for the status `200`

[Operation history](https://skmtc.dev/jane/apis/jdp-api/changes/api/2026-01-01/medical-record/care-plans/get.md)

---

[API](https://skmtc.dev/jane/apis/jdp-api.md) - [All operations](https://skmtc.dev/jane/apis/jdp-api/llms.txt) - [OpenAPI document](https://skmtc.dev/jane/apis/jdp-api/revisions/01798f613a5e?raw)