> ## Documentation Index > Fetch the complete documentation index at: https://developer.vetcove.com/llms.txt > Use this file to discover all available pages before exploring further. # List all patient care plans > 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. ## OpenAPI ````yaml get /ext/v2/patient-care-plans/ openapi: 3.1.0 info: description: '' title: NinjaAPI version: 2.0.0 servers: - url: https://connect.vetcove.com/ security: [] paths: /ext/v2/patient-care-plans/: get: tags: - Care Plans summary: List all patient care plans description: >- 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. operationId: patient_care_plans_list parameters: - description: When provided, filters to objects with these IDs. in: query name: ids required: false schema: anyOf: - items: type: integer type: array - type: 'null' description: When provided, filters to objects with these IDs. title: Ids - description: >- 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`. in: query name: ending_before required: false schema: anyOf: - type: integer - type: 'null' description: >- 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`. title: Ending Before - description: >- 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`. in: query name: starting_after required: false schema: anyOf: - type: integer - type: 'null' description: >- 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`. title: Starting After - description: The maximum number of items to return per page. in: query name: limit required: false schema: default: 10 description: The maximum number of items to return per page. maximum: 100 minimum: 1 title: Limit type: integer - description: >- When provided, filters to patient care plans for the clinic with this ID in: query name: clinic_id required: false schema: anyOf: - type: integer - type: 'null' description: >- When provided, filters to patient care plans for the clinic with this ID title: Clinic Id - description: >- When provided, filters to patient care plans for the clinic client with this ID in: query name: clinic_client_id required: false schema: anyOf: - type: integer - type: 'null' description: >- When provided, filters to patient care plans for the clinic client with this ID title: Clinic Client Id - description: >- When provided, filters to patient care plans for the clinic patient with this ID in: query name: clinic_patient_id required: false schema: anyOf: - type: integer - type: 'null' description: >- When provided, filters to patient care plans for the clinic patient with this ID title: Clinic Patient Id - description: When provided, filters to patient care plans with this status in: query name: status required: false schema: anyOf: - $ref: '#/components/schemas/PatientCarePlanStatus' - type: 'null' description: When provided, filters to patient care plans with this status - description: >- When provided, filters to patient care plans by billing type. True returns plans billed monthly, False returns plans billed upfront. in: query name: is_billed_monthly required: false schema: anyOf: - type: boolean - type: 'null' description: >- When provided, filters to patient care plans by billing type. True returns plans billed monthly, False returns plans billed upfront. title: Is Billed Monthly responses: '200': content: application/json: schema: $ref: '#/components/schemas/ExternalPatientCarePlanSchemaList' description: OK security: - ExternalAPIAuth: [] components: schemas: PatientCarePlanStatus: enum: - IMPORTED - CLIENT_CREATED - CLINIC_CREATED - ACTIVE - TERMINATED - PAYMENT_FAILED - SUSPENDED title: PatientCarePlanStatus type: string ExternalPatientCarePlanSchemaList: properties: data: description: A single page of data contained within this list. items: $ref: '#/components/schemas/ExternalPatientCarePlanSchema' title: Data type: array has_more: default: false description: Whether there are more pages or data in this list. title: Has More type: boolean next_page: description: A URL linking to the next page of this list. title: Next Page type: string type: default: list description: Type of this object. Always `list`. title: Type type: string required: - data - next_page title: ExternalPatientCarePlanSchemaList type: object ExternalPatientCarePlanSchema: properties: care_plan_id: description: The ID of the Care Plan this patient-specific plan is linked to title: Care Plan Id type: integer care_plan_kind: $ref: '#/components/schemas/CarePlanKind' description: The type of the care plan care_plan_name: description: The name of the care plan this patient care plan is linked to title: Care Plan Name type: string clinic_client_id: description: >- The ID of the clinic client this patient care plan is associated with title: Clinic Client Id type: integer clinic_id: description: The ID of the clinic this patient care plan is associated with title: Clinic Id type: integer clinic_patient_id: description: The ID of the clinic patient this care plan is associated with title: Clinic Patient Id type: integer core_plan_id: anyOf: - type: integer - type: 'null' description: >- The ID of the core patient care plan this one is linked to, if this is an add-on plan title: Core Plan Id deactivated_at: anyOf: - format: date-time type: string - type: 'null' description: When this care plan was deactivated, if applicable title: Deactivated At deactivated_by: anyOf: - type: string - type: 'null' description: The name of the user who deactivated the care plan, if applicable title: Deactivated By end_date: description: >- 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. format: date title: End Date type: string enrollment_fee: description: The enrollment fee of the care plan minimum: 0 title: Enrollment Fee type: integer id: description: The unique identifier for the patient care plan title: Id type: integer is_billed_monthly: description: Whether the care plan is billed monthly or upfront title: Is Billed Monthly type: boolean monthly_cost: anyOf: - minimum: 0 type: integer - type: 'null' description: >- The monthly cost of the care plan, in cents. Only applicable to monthly billed care plans. title: Monthly Cost next_payment_date: anyOf: - format: date type: string - type: 'null' description: The date of the next payment for the care plan, if applicable title: Next Payment Date next_plan_id: anyOf: - type: integer - type: 'null' description: The ID of the next care plan, if applicable title: Next Plan Id payment_method_id: anyOf: - type: integer - type: 'null' description: The ID of the payment method associated with this care plan title: Payment Method Id plan_cost: description: The cost of the care plan minimum: 0 title: Plan Cost type: integer remaining_balance: description: The remaining balance of the care plan, in cents title: Remaining Balance type: integer should_renew: description: Whether this care plan will automatically be renewed title: Should Renew type: boolean start_date: description: The start date of the care plan format: date title: Start Date type: string status: anyOf: - $ref: '#/components/schemas/PatientCarePlanStatus' - const: '' type: string description: The status of the patient care plan title: Status required: - id - clinic_patient_id - clinic_id - clinic_client_id - care_plan_id - start_date - end_date - deactivated_at - status - core_plan_id - next_plan_id - should_renew - plan_cost - enrollment_fee - care_plan_name - care_plan_kind - deactivated_by - next_payment_date - remaining_balance - is_billed_monthly - monthly_cost - payment_method_id title: ExternalPatientCarePlanSchema type: object CarePlanKind: enum: - CORE - ADD_ON - SERVICE_PACKAGE title: CarePlanKind type: string securitySchemes: ExternalAPIAuth: scheme: bearer type: http ````