Skip to main content

​
Overview

Cohorts allow you to configure shared patient settings. For example, you could create one cohort to monitor a group of chronically-ill individuals with all features enabled (e.g., ADTs, pharmacies, laboratory, HIE), and another cohort that monitors a less critical group of individuals with just HIE data enabled.
If you’d like us to create a cohort that includes ADT, pharmacy, or laboratory monitoring, please note these are premium features and require those services to be activated on your account. Let us know if you’d like to add them.

​
Getting Started

Every cohort has a unique name and a collection of settings which apply to all patients within that cohort. These settings control what data sources are monitored, how frequently queries are run, and what notifications are sent. A patient can be in multiple cohorts, which allows for flexible monitoring configurations. If any cohort enables a particular monitoring feature, that feature will be active for the patient.
All of this can be personalized based on your needs, either during onboarding or self-serve, via our API (See our API reference for documentation on how to update an existing cohort or add existing patients to a cohort).

​
The Cohort Model

In Metriport, a cohort is simply a label that can be given to any number of patients. You can use that label to apply common settings across a group of patients, or retrieve the members of that cohort via API. 
{
  "name": "High Risk",
  "description": "Members of this cohort are opted-in to all available data sources.",
  "color": "red",
  "settings": {
    "monitoring": {
      "adt": {
        "enabled": true
      },
      "hie": {
        "enabled": true,
        "frequency": "weekly"
      },
      "pharmacy": {
        "notifications": true,
        "schedule": {
          "enabled": false,
          "frequency": "monthly"
        }
      },
      "laboratory": {
        "notifications": true
      }
    }
  }
}
See Here for a detailed explanation of the available settings.

​
Monitoring Patients with Cohorts

Metriport allows you to monitor patients and receive notifications about them over time. To do this, ask us to create a cohort for you and specify the settings you wish to have. Then add patients that need to be monitored to the cohort. The settings of the cohort are now applied to the patient (what monitoring is set, schedule, etc.). 
// 1. Get the cohort created by Metriport
const cohortId = "00000000-0000-0000-0000-000000000000";

// 2. Add patients to the cohort
const patientsInCohort = await metriportApi.addPatientsToCohort({
  cohortId,
  patientIds: [
    "11111111-1111-1111-1111-111111111111",
    "22222222-2222-2222-2222-222222222222",
  ]
});
Setting a patient’s cohorts as you create them is the easiest way + recommended way of enabling monitoring.
Alternatively, just create your patients as usual (via API call or bulk patient create) and specify the desired cohorts. 
// Create a patient and assign to existing cohorts
const patient = await metriportApi.createPatient(
  {
    firstName: "John",
    lastName: "Doe",
    dob: "1990-01-01",
    genderAtBirth: "M",
    address: [
      {
        addressLine1: "123 Main St",
        city: "Anytown",
        state: "CA",
        zip: "12345",
        country: "USA",
      },
    ],
    // Assign cohorts during creation
    cohorts: [
      "00000000-0000-0000-0000-000000000000", 
      "11111111-1111-1111-1111-111111111111"
    ], 
  },
  facilityId
);

// The patient is now automatically subscribed to the monitoring settings of the 2 cohorts

​
Adding Patients to Cohorts

Patients can be added to cohorts on creation, or added to and removed from different cohorts as needed. During creation:
  • In Bulk Patient Create there are cohort1 and cohort2 column headers for specifying the starting cohorts for a patient. See here.
  • In Create Patient there is a cohorts array parameter to set any number of cohorts on a patient. See here.
As needed:

​
Available Settings

Use settings to enable monitoring for certain data sources. To configure cohort settings, please contact us.
​
monitoring
object

​
Additional Information

Click here for additional information related to patient monitoring.