---
title: "Retrieve a list of existing caregap."
method: GET
path: "/caregaps/api/{quality_program}/caregap/"
tags: ["Caregaps"]
---

# Retrieve a list of existing caregap.

`GET /caregaps/api/{quality_program}/caregap/`

Retrieve a list of Care Gaps with filters specified by query parameters.

## Path parameters

- `quality_program` string, required

## Query parameters

- `practice_id` string
- `page_size` integer
- `cursor` string
- `patient_id` string
- `definition_id` string
- `status` 'open' | 'closed' — An enumeration.
- `closed_date_begin` string, date
- `closed_date_end` string, date

## Request body

- string[]

## Response `200`

Successful Response

- CaregapAPIPaginatedResponse
  - `results` CaregapAPI[], required — Page of results requested
    - `definition_id` string, required — Definition id this caregap is associated with.
    - `patient_id` string, required — Patient id this caregap is associated with.
    - `practice_id` string, required — Practice id this caregap is associated with.
    - `created_date` string, date, required — ISO timestamp for when this caregap was created.
    - `status` 'open' | 'closed', required — An enumeration.
    - `detail` string — Extra detail about the caregap.
    - `closed_date` string, date — ISO timestamp for when the caregap was closed.
    - `closed_by` 'API' | 'condition-saved' | 'feedback' — An enumeration.
    - `id` string, required — UUID to identify the caregap
    - `quality_program` string, required — Quality program this caregap is associated with.
  - `cursor` string — Cursor to query for the next page
  - `next_page_url` string — Full URL to query for the next page

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/elationhealth/apis/billing-api.md) · [All operations](https://skmtc.dev/elationhealth/apis/billing-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/elationhealth/billing-api/revisions/0acfdeb9bd9b/schema)