---
updatedAt: 2026-08-07T16:25:02.000Z
agentTools:
  projectIndex: https://docs.elationhealth.com/llms.txt
---

# Retrieve an existing caregap.

Retrieve a specific Care Gap.

# OpenAPI definition

```json
{
  "openapi": "3.0.2",
  "info": {
    "title": "Care Gaps API",
    "description": "This API supports the management of definitions, gaps, and webhook notifications.",
    "version": "0.0.1"
  },
  "servers": [
    {
      "url": "https://caregaps.sandbox.elationemr.com/",
      "description": "CareGaps API - Sandbox Environment"
    }
  ],
  "paths": {
    "/caregaps/api/{quality_program}/caregap/{caregap_id}/": {
      "get": {
        "tags": [
          "Caregaps"
        ],
        "summary": "Retrieve an existing caregap.",
        "description": "Retrieve a specific Care Gap.",
        "operationId": "caregaps_get_caregaps_api__quality_program__caregap__caregap_id___get",
        "parameters": [
          {
            "required": true,
            "schema": {
              "title": "Quality Program",
              "type": "string"
            },
            "name": "quality_program",
            "in": "path"
          },
          {
            "required": true,
            "schema": {
              "title": "Caregap Id",
              "type": "string"
            },
            "name": "caregap_id",
            "in": "path"
          },
          {
            "required": false,
            "schema": {
              "title": "Practice Id",
              "type": "string"
            },
            "name": "practice_id",
            "in": "query"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CaregapAPI"
                }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        },
        "security": [
          {
            "OAuth2PasswordBearer": []
          }
        ]
      }
    }
  },
  "components": {
    "schemas": {
      "CaregapAPI": {
        "title": "CaregapAPI",
        "required": [
          "definition_id",
          "patient_id",
          "practice_id",
          "created_date",
          "status",
          "id",
          "quality_program"
        ],
        "type": "object",
        "properties": {
          "definition_id": {
            "title": "Definition Id",
            "type": "string",
            "description": "Definition id this caregap is associated with."
          },
          "patient_id": {
            "title": "Patient Id",
            "type": "string",
            "description": "Patient id this caregap is associated with."
          },
          "practice_id": {
            "title": "Practice Id",
            "type": "string",
            "description": "Practice id this caregap is associated with."
          },
          "created_date": {
            "title": "Created Date",
            "type": "string",
            "description": "ISO timestamp for when this caregap was created.",
            "format": "date"
          },
          "status": {
            "allOf": [
              {
                "$ref": "#/components/schemas/StatusEnum"
              }
            ],
            "description": "Current status of the caregap"
          },
          "detail": {
            "title": "Detail",
            "type": "string",
            "description": "Extra detail about the caregap."
          },
          "closed_date": {
            "title": "Closed Date",
            "type": "string",
            "description": "ISO timestamp for when the caregap was closed.",
            "format": "date"
          },
          "closed_by": {
            "allOf": [
              {
                "$ref": "#/components/schemas/ClosedByEnum"
              }
            ],
            "description": "Who or what action closed the caregap."
          },
          "id": {
            "title": "Id",
            "type": "string",
            "description": "UUID to identify the caregap"
          },
          "quality_program": {
            "title": "Quality Program",
            "type": "string",
            "description": "Quality program this caregap is associated with."
          }
        }
      },
      "ClosedByEnum": {
        "title": "ClosedByEnum",
        "enum": [
          "API",
          "condition-saved",
          "feedback"
        ],
        "type": "string",
        "description": "An enumeration."
      },
      "HTTPValidationError": {
        "title": "HTTPValidationError",
        "type": "object",
        "properties": {
          "detail": {
            "title": "Detail",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ValidationError"
            }
          }
        }
      },
      "StatusEnum": {
        "title": "StatusEnum",
        "enum": [
          "open",
          "closed"
        ],
        "type": "string",
        "description": "An enumeration."
      },
      "ValidationError": {
        "title": "ValidationError",
        "required": [
          "loc",
          "msg",
          "type"
        ],
        "type": "object",
        "properties": {
          "loc": {
            "title": "Location",
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "msg": {
            "title": "Message",
            "type": "string"
          },
          "type": {
            "title": "Error Type",
            "type": "string"
          }
        }
      }
    },
    "securitySchemes": {
      "OAuth2PasswordBearer": {
        "type": "oauth2",
        "flows": {
          "password": {
            "scopes": {},
            "tokenUrl": "token"
          }
        }
      }
    }
  },
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  }
}
```