Skip to main content
GET
/
medical
/
v1
/
care-gaps
/
{measureReportId}
Get Care Gap
curl --request GET \
  --url https://api.sandbox.metriport.com/medical/v1/care-gaps/{measureReportId} \
  --header 'x-api-key: <api-key>'
curl -X GET 'https://api.metriport.com/medical/v1/care-gaps/BreastCancerScreening.00000000-0000-0000-0000-000000000000.2025-01-01' \
  -H 'x-api-key: YOUR_API_KEY'
Analytics must be enabled for your account to receive data from this endpoint. Contact us to get started.
Returns a FHIR Bundle for a specific care gap. The first entry is the full MeasureReport including population membership data. The second entry is a Parameters resource containing supporting calculation details for the patient and measure. For more context on care gaps and how to interpret results, see the Care Gaps guide.

​
Path Params

​
measureReportId
string
required
The ID of the MeasureReport to retrieve.

​
Response

A FHIR Bundle with type: "collection".
​
MeasureReport
MeasureReport
required
The care gap measure report including population membership data and a job-id extension.
​
Parameters
Parameters
required
Supporting calculation parameters for this patient and measure.
curl -X GET 'https://api.metriport.com/medical/v1/care-gaps/BreastCancerScreening.00000000-0000-0000-0000-000000000000.2025-01-01' \
  -H 'x-api-key: YOUR_API_KEY'
Response
{
  "resourceType": "Bundle",
  "type": "collection",
  "entry": [
    {
      "fullUrl": "urn:uuid:11111111-1111-1111-1111-111111111111",
      "resource": {
        "resourceType": "MeasureReport",
        "id": "BreastCancerScreening.00000000-0000-0000-0000-000000000000.2025-01-01",
        "status": "complete",
        "type": "individual",
        "measure": "http://ncqa.org/fhir/Measure/BreastCancerScreening",
        "subject": {
          "reference": "Patient/00000000-0000-0000-0000-000000000000"
        },
        "period": {
          "start": "2025-01-01",
          "end": "2025-12-31"
        },
        "extension": [
          {
            "url": "https://public.metriport.com/fhir/StructureDefinition/job-id",
            "valueString": "11111111-1111-1111-1111-111111111111"
          }
        ],
        "group": [
          {
            "id": "BreastCancerScreening",
            "code": {
              "coding": [
                {
                  "system": "https://ncqa.org/fhir/CodeSystem/measure-group",
                  "code": "BreastCancerScreening"
                }
              ]
            },
            "population": [
              {
                "code": {
                  "coding": [
                    {
                      "system": "https://ncqa.org/fhir/CodeSystem/measure-group",
                      "code": "initial-population"
                    }
                  ]
                },
                "count": 1
              },
              {
                "code": {
                  "coding": [
                    {
                      "system": "https://ncqa.org/fhir/CodeSystem/measure-group",
                      "code": "denominator"
                    }
                  ]
                },
                "count": 1
              },
              {
                "code": {
                  "coding": [
                    {
                      "system": "https://ncqa.org/fhir/CodeSystem/measure-group",
                      "code": "denominator-exclusion"
                    }
                  ]
                },
                "count": 0
              },
              {
                "code": {
                  "coding": [
                    {
                      "system": "https://ncqa.org/fhir/CodeSystem/measure-group",
                      "code": "numerator"
                    }
                  ]
                },
                "count": 0
              }
            ]
          }
        ]
      }
    },
    {
      "fullUrl": "urn:uuid:22222222-2222-2222-2222-222222222222",
      "resource": {
        "resourceType": "Parameters",
        "parameter": [
          {
            "name": "Age at end of measurement period",
            "valueInteger": 42
          },
          {
            "name": "Is continuously enrolled",
            "valueBoolean": true
          },
          {
            "name": "Initial population",
            "valueBoolean": true
          },
          {
            "name": "Denominator",
            "valueBoolean": true
          },
          {
            "name": "Numerator",
            "valueBoolean": false
          },
          {
            "name": "Mammography screening period",
            "valuePeriod": {
              "start": "2023-10-01",
              "end": "2025-12-31"
            }
          }
        ]
      }
    }
  ]
}