---
title: "List all patient care plans"
method: GET
path: "/ext/v2/patient-care-plans/"
tags: ["Care Plans"]
---

# List all patient care plans

`GET /ext/v2/patient-care-plans/`

## Request

- Base URL: `https://connect.vetcove.com`
- URL: `https://connect.vetcove.com/ext/v2/patient-care-plans/`
- Auth: HTTP bearer

Returns a list of all patient care plan enrollments across the organization. The patient care plans are sorted by creation date, with the most recent appearing first.

A **patient care plan** represents a specific patient's enrollment in a care plan template. It tracks the enrollment status, billing details, start and end dates, and renewal configuration. A single patient can be enrolled in one core plan and multiple add-on plans simultaneously.

## Query parameters

- `ids` integer[], nullable: When provided, filters to objects with these IDs.
- `ending_before` integer, nullable: A cursor used for pagination. Fetches the page of results ending immediately before the object with the given ID. Cannot be used at the same time as `starting_after`.
- `starting_after` integer, nullable: A cursor used for pagination. Fetches the page of results starting immediately after the given ID. Cannot be used at the same time as `ending_before`.
- `limit` integer: The maximum number of items to return per page.
- `clinic_id` integer, nullable: When provided, filters to patient care plans for the clinic with this ID
- `clinic_client_id` integer, nullable: When provided, filters to patient care plans for the clinic client with this ID
- `clinic_patient_id` integer, nullable: When provided, filters to patient care plans for the clinic patient with this ID
- `status` 'IMPORTED' | 'CLIENT_CREATED' | 'CLINIC_CREATED' | 'ACTIVE' | 'TERMINATED' | 'PAYMENT_FAILED' | 'SUSPENDED'
- `is_billed_monthly` boolean, nullable: When provided, filters to patient care plans by billing type. True returns plans billed monthly, False returns plans billed upfront.

## Response `200`

OK

- ExternalPatientCarePlanSchemaList
  - `data` ExternalPatientCarePlanSchema[], required: A single page of data contained within this list.
    - `care_plan_id` integer, required: The ID of the Care Plan this patient-specific plan is linked to
    - `care_plan_kind` 'CORE' | 'ADD_ON' | 'SERVICE_PACKAGE', required
    - `care_plan_name` string, required: The name of the care plan this patient care plan is linked to
    - `clinic_client_id` integer, required: The ID of the clinic client this patient care plan is associated with
    - `clinic_id` integer, required: The ID of the clinic this patient care plan is associated with
    - `clinic_patient_id` integer, required: The ID of the clinic patient this care plan is associated with
    - `core_plan_id` integer, nullable, required: The ID of the core patient care plan this one is linked to, if this is an add-on plan
    - `deactivated_at` string, date-time, nullable, required: When this care plan was deactivated, if applicable
    - `deactivated_by` string, nullable, required: The name of the user who deactivated the care plan, if applicable
    - `end_date` string, date, required: End date for the care plan (YYYY-MM-DD). This is non-inclusive, meaning a plan ending on 2/1/2026 would not be considered active/usable on 2/1/2026.
    - `enrollment_fee` integer, required: The enrollment fee of the care plan
    - `id` integer, required: The unique identifier for the patient care plan
    - `is_billed_monthly` boolean, required: Whether the care plan is billed monthly or upfront
    - `monthly_cost` integer, nullable, required: The monthly cost of the care plan, in cents. Only applicable to monthly billed care plans.
    - `next_payment_date` string, date, nullable, required: The date of the next payment for the care plan, if applicable
    - `next_plan_id` integer, nullable, required: The ID of the next care plan, if applicable
    - `payment_method_id` integer, nullable, required: The ID of the payment method associated with this care plan
    - `plan_cost` integer, required: The cost of the care plan
    - `remaining_balance` integer, required: The remaining balance of the care plan, in cents
    - `should_renew` boolean, required: Whether this care plan will automatically be renewed
    - `start_date` string, date, required: The start date of the care plan
    - `status` union, required: The status of the patient care plan
      - 'IMPORTED' | 'CLIENT_CREATED' | 'CLINIC_CREATED' | 'ACTIVE' | 'TERMINATED' | 'PAYMENT_FAILED' | 'SUSPENDED'
      - ''
  - `has_more` boolean: Whether there are more pages or data in this list.
  - `next_page` string, required: A URL linking to the next page of this list.
  - `type` string: Type of this object. Always `list`.

---

[API](https://skmtc.dev/vetcove/apis/ninjaapi.md) - [All operations](https://skmtc.dev/vetcove/apis/ninjaapi/llms.txt) - [OpenAPI document](https://skmtc.dev/vetcove/apis/ninjaapi/revisions/4ceaed956e15?raw)