> ## Documentation Index
> Fetch the complete documentation index at: https://docs.metriport.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Patient Suspects

> Lists suspected conditions for a single patient as FHIR Bundles (analytics).

<ResponseExample />

<Warning>
  Analytics must be enabled for your account to receive data
  from this endpoint. [Contact
  us](mailto:contact@metriport.com) to get started.
</Warning>

Returns a paginated list of suspected conditions for the patient identified by `patientId` in the path.
Each result is a FHIR `Bundle` that includes a `Patient` resource, the suspected `Condition`, and evidence
resources (Observations, Procedures, MedicationRequests) that support the suspicion.

For more context on suspecting and how to interpret results, see the
[Suspecting guide](/medical-api/handling-data/suspecting).

## Path Params

<ParamField path="patientId" type="string" required>
  The Metriport Patient ID.
</ParamField>

## Query Params

<ParamField query="limit" type="number" optional>
  Maximum number of results to return. Must be between 1 and
  100\. Defaults to `20`.
</ParamField>

<ParamField query="offset" type="number" optional>
  Number of results to skip for pagination. Must be 0 or
  greater. Defaults to `0`.
</ParamField>

## Response

<ResponseField name="metadata" type="object" required>
  Pagination metadata.

  <Expandable title="metadata properties">
    <ResponseField name="total" type="number" required>
      Total number of suspected condition records matching
      the query for this patient.
    </ResponseField>

    <ResponseField name="limit" type="number" required>
      The limit used for this request.
    </ResponseField>

    <ResponseField name="offset" type="number" required>
      The offset used for this request.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="results" type="Bundle[]" required>
  Array of FHIR Bundle resources. Each bundle contains a
  `Patient`, a `Condition`, and its supporting evidence.

  <Expandable title="Bundle properties">
    <ResponseField name="Patient" type="Patient" required>
      The patient this suspected condition applies to.

      <Expandable title="Patient properties">
        <Snippet file="analytics-bundle-patient-response.mdx" />
      </Expandable>
    </ResponseField>

    <ResponseField name="Condition" type="Condition" required>
      The suspected condition.

      <Expandable title="Condition properties">
        <Snippet file="suspect-condition-response.mdx" />
      </Expandable>
    </ResponseField>

    <ResponseField name="Observation | Procedure | MedicationRequest" type="Observation | Procedure | MedicationRequest">
      Evidence resources supporting the suspicion.

      <Expandable title="Observation properties">
        <Snippet file="suspect-observation-response.mdx" />
      </Expandable>

      <Expandable title="Procedure properties">
        <Snippet file="suspect-procedure-response.mdx" />
      </Expandable>

      <Expandable title="MedicationRequest properties">
        <Snippet file="suspect-medication-request-response.mdx" />
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

```json Response theme={null}
{
  "metadata": {
    "total": 1,
    "limit": 20,
    "offset": 0
  },
  "results": [
    {
      "resourceType": "Bundle",
      "type": "collection",
      "entry": [
        {
          "fullUrl": "urn:uuid:11111111-1111-1111-1111-111111111111",
          "resource": {
            "resourceType": "Patient",
            "id": "00000000-0000-0000-0000-000000000000",
            "identifier": [
              {
                "value": "1234567890",
                "system": "https://public.metriport.com/fhir/StructureDefinition/external-id.json",
                "use": "secondary"
              }
            ],
            "name": [
              { "given": ["Sam"], "family": "Example" }
            ],
            "gender": "male",
            "birthDate": "1975-03-20"
          }
        },
        {
          "fullUrl": "urn:uuid:55555555-5555-5555-5555-555555555555",
          "resource": {
            "resourceType": "Condition",
            "id": "88888888-8888-8888-8888-888888888888",
            "subject": {
              "reference": "Patient/00000000-0000-0000-0000-000000000000"
            },
            "code": {
              "coding": [
                {
                  "system": "http://hl7.org/fhir/sid/icd-10-cm",
                  "code": "E11.9",
                  "display": "Type 2 diabetes mellitus without complications"
                }
              ]
            },
            "verificationStatus": {
              "coding": [
                {
                  "system": "http://terminology.hl7.org/CodeSystem/condition-ver-status",
                  "code": "unconfirmed",
                  "display": "Unconfirmed"
                }
              ]
            },
            "extension": [
              {
                "url": "https://public.metriport.com/fhir/StructureDefinition/suspect-type",
                "valueString": "suspect"
              },
              {
                "url": "https://public.metriport.com/fhir/StructureDefinition/evidence-count",
                "valueInteger": 3
              },
              {
                "url": "https://public.metriport.com/fhir/StructureDefinition/first-evidence-date",
                "valueDate": "2023-09-21"
              },
              {
                "url": "https://public.metriport.com/fhir/StructureDefinition/last-evidence-date",
                "valueDate": "2023-09-27"
              },
              {
                "url": "https://public.metriport.com/fhir/StructureDefinition/hcc-code",
                "valueString": "38"
              },
              {
                "url": "https://public.metriport.com/fhir/StructureDefinition/job-id",
                "valueString": "22222222-2222-2222-2222-222222222222"
              }
            ],
            "evidence": [
              {
                "code": [
                  {
                    "coding": [
                      {
                        "system": "https://public.metriport.com/fhir/CodeSystem/suspect-manifestation",
                        "code": "diabetes_fpg_126_199",
                        "display": "Diabetes (FPG 126-199 mg/dL)"
                      }
                    ],
                    "text": "Fasting glucose 126-199 mg/dL on two separate dates."
                  }
                ],
                "detail": [
                  {
                    "type": "Observation",
                    "reference": "Observation/33333333-3333-3333-3333-333333333333"
                  },
                  {
                    "type": "Observation",
                    "reference": "Observation/44444444-4444-4444-4444-444444444444"
                  }
                ]
              }
            ]
          }
        },
        {
          "fullUrl": "urn:uuid:66666666-6666-6666-6666-666666666666",
          "resource": {
            "resourceType": "Observation",
            "id": "33333333-3333-3333-3333-333333333333",
            "status": "final",
            "code": {
              "coding": [
                {
                  "system": "http://loinc.org",
                  "code": "1558-6"
                }
              ]
            },
            "effectiveDateTime": "2023-09-27",
            "valueQuantity": {
              "value": 141,
              "unit": "mg/dL"
            }
          }
        },
        {
          "fullUrl": "urn:uuid:77777777-7777-7777-7777-777777777777",
          "resource": {
            "resourceType": "Observation",
            "id": "44444444-4444-4444-4444-444444444444",
            "status": "final",
            "code": {
              "coding": [
                {
                  "system": "http://loinc.org",
                  "code": "1558-6"
                }
              ]
            },
            "effectiveDateTime": "2023-09-23",
            "valueQuantity": {
              "value": 152,
              "unit": "mg/dL"
            }
          }
        }
      ]
    }
  ]
}
```