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

# List all care benefits

`GET /ext/v2/care-benefits/`

## Request

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

This endpoint is available to Group API Keys only.

Returns a list of all care benefits included in a specific care plan.

A **care benefit** represents a specific service or group of services that a patient receives as part of their care plan enrollment. Benefits can be point-based (a pool of points the patient can redeem for eligible services) or fixed (specific services included in the plan).

## 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.
- `care_plan_id` integer, required: Filter to care benefits for the care plan with this ID

## Response `200`

OK

- ExternalCareBenefitSchemaList
  - `data` ExternalCareBenefitSchema[], required: A single page of data contained within this list.
    - `care_benefit_services` ExternalCareBenefitServicesSchema[], required: The services that are part of this care benefit
      - `group_bundle_id` integer, nullable, required: The ID of the group bundle this service belongs to
      - `group_bundle_name` string, nullable: The name of the group bundle this service belongs to
      - `group_service_id` integer, nullable, required: The ID of the group service
      - `group_service_name` string, nullable: The name of the group service
      - `id` integer, required: The ID of the care benefit service
      - `points` integer, nullable, required: The number of points this service is worth in this benefit
    - `category` 'PREVENTATIVE_AND_WELLNESS' | 'DIAGNOSTIC_AND_MONITORING' | 'ROUTINE_AND_CONVENIENCE' | 'DENTAL_AND_SPECIALIZED' | 'FOOD_AND_NUTRITION', required
    - `excluded_services` integer[], required: The group service IDs that are excluded from this care benefit
    - `id` integer, required: The ID of the care benefit
    - `kind` 'UNLIMITED' | 'POINTS' | 'DISCOUNT', required
    - `name` string, required: The name of the care benefit
    - `service_categories` integer[], required: The service category IDs that are part of this care benefit
    - `status` 'ACTIVE' | 'INACTIVE', required
  - `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)