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

# List all care plans

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

## Request

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

This endpoint is available to Group API Keys only.

Returns a list of all care plan templates defined at the organization level. The care plans are sorted by creation date, with the most recent care plans appearing first.

A **care plan** is a template for recurring veterinary care that can be offered to patients. Care plans come in two types:

- **Core Plans**: A plan for some defined period of time that typically include a physical exam, vaccinations, and other routine care.
- **Add-ons**: Optional plans purchased in addition to a core plan (e.g., 12 months of flea and tick prevention).

These are organization-level templates. To see which patients are enrolled in care plans, use the patient care plans endpoints.

## 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.
- `species` 'CANINE' | 'FELINE' | 'EQUINE' | 'AVIAN' | 'BOVINE' | 'FERRET' | 'RABBIT' | 'RODENT' | 'REPTILE' | 'AMPHIBIAN' | 'FISH' | 'PORCINE' | 'CAPRINE' | 'SHEEP' | 'CAMELID' | 'RATITE' | 'MARSUPIAL' | 'MUSTELID' | 'CERVID' | 'PROCYONIDAE' | 'ERINACEIDAE' | 'MEPHITIDAE' | 'OTHER' | 'UNSPECIFIED'

## Response `200`

OK

- ExternalCarePlanSchemaList
  - `data` ExternalCarePlanSchema[], required: A single page of data contained within this list.
    - `code` string, required: The unique identifier (within a group) for this care plan.
    - `default_duration_unit` union, required: The unit of the default duration
      - 'DAY' | 'WEEK' | 'MONTH' | 'YEAR'
      - ''
    - `default_duration_value` integer, nullable, required: The value for the default duration of the care plan. Typically, this will be 12 months.
    - `id` integer, required: The unique identifier for the care plan
    - `kind` union, required: The type of the care plan
      - 'CORE' | 'ADD_ON' | 'SERVICE_PACKAGE'
      - ''
    - `max_age_unit` union, required: The unit of the maximum age
      - 'DAY' | 'WEEK' | 'MONTH' | 'YEAR'
      - ''
    - `max_age_value` integer, nullable, required: The maximum age of the patient to be eligible for the care plan. Clinics can enroll a patient in any care plan, but this value will be used for client initiated enrollments and automatic renewals into new care plans
    - `min_age_unit` union, required: The unit of the minimum age
      - 'DAY' | 'WEEK' | 'MONTH' | 'YEAR'
      - ''
    - `min_age_value` integer, nullable, required: The minimum age of the patient to be eligible for the care plan. Clinics can enroll a patient in any care plan, but this value will be used for client initiated enrollments and automatic renewals into new care plans
    - `name` string, required: The name of the care plan
    - `next_plan_id` integer, nullable, required: The ID of the next Care Plan this plan transitions to. Only applicable to Core plans. When a patient meets the age and eligibility requirements of the next plan, they will be automatically transitioned to that plan upon renewal.
    - `species` union, required: The species this care plan is for
      - 'CANINE' | 'FELINE' | 'EQUINE' | 'AVIAN' | 'BOVINE' | 'FERRET' | 'RABBIT' | 'RODENT' | 'REPTILE' | 'AMPHIBIAN' | 'FISH' | 'PORCINE' | 'CAPRINE' | 'SHEEP' | 'CAMELID' | 'RATITE' | 'MARSUPIAL' | 'MUSTELID' | 'CERVID' | 'PROCYONIDAE' | 'ERINACEIDAE' | 'MEPHITIDAE' | 'OTHER' | 'UNSPECIFIED'
      - ''
    - `status` union, required: The status of the care plan
      - 'ACTIVE' | 'INACTIVE'
      - ''
  - `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)