Getting Started
API Reference
Handling Data
FHIR
Add Patient to Cohorts
Copy
Ask AI
curl --request POST \
--url https://api.sandbox.metriport.com/medical/v1/patient/{id}/cohort \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"cohortIds": [
"<string>"
]
}
'Copy
Ask AI
import { MetriportMedicalApi } from "@metriport/api-sdk";
const metriport = new MetriportMedicalApi("YOUR_API_KEY");
const patientId = "00000000-0000-0000-0000-000000000000";
const result = await metriport.addPatientToCohorts(patientId, {
cohortIds: [
"00000000-0000-0000-0000-000000000000",
"11111111-1111-1111-1111-111111111111"
]
});
Patient
Add Patient to Cohorts
Adds a single patient to multiple cohorts at once. Returns all cohorts the patient is associated with.
POST
/
medical
/
v1
/
patient
/
{id}
/
cohort
Add Patient to Cohorts
Copy
Ask AI
curl --request POST \
--url https://api.sandbox.metriport.com/medical/v1/patient/{id}/cohort \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"cohortIds": [
"<string>"
]
}
'Copy
Ask AI
import { MetriportMedicalApi } from "@metriport/api-sdk";
const metriport = new MetriportMedicalApi("YOUR_API_KEY");
const patientId = "00000000-0000-0000-0000-000000000000";
const result = await metriport.addPatientToCohorts(patientId, {
cohortIds: [
"00000000-0000-0000-0000-000000000000",
"11111111-1111-1111-1111-111111111111"
]
});
For more information, see the guide about Cohorts
Path Params
The ID of the patient to add to cohorts.
Body
Array of cohort IDs to add the patient to.
Response
Array of cohorts the patient is currently associated with.
Show Cohort properties
Show Cohort properties
The unique identifier for the cohort (UUID format, e.g.,
00000000-0000-0000-0000-000000000000).The entity tag for optimistic concurrency control.
The unique name of the cohort within your organization.
The description of the cohort.
The color associated with the cohort.
Configuration settings for the cohort.
Show Settings properties
Show Settings properties
Hide monitoring object properties
Hide monitoring object properties
HIE-based document monitoring - subscribes patients to HIE-based
document monitoring (non-ADT) / medical record refresh based on the cadence.
Show hie object properties
Show hie object properties
Enable or disable scheduled data pulls for HIE monitoring. Defaults to disabled.
When disabled, no scheduled pulls will occur regardless of the frequency setting.
How often scheduled data pulls should occur, can be one of
weekly or biweekly or monthly. Defaults to monthly.See scheduled queries
for timing details.
HIE monitoring is coming soon! While this feature is not yet live, you can configure
your HIE monitoring settings now. These settings will automatically take effect when the feature launches.
ADT (Admission, Discharge, Transfer) monitoring - subscribes patients to ADT notifications
based on their primary address.
Show adt object properties
Show adt object properties
Enable or disable ADT monitoring notifications. Defaults to disabled.
Pharmacy / medication history monitoring - enables retail fill data monitoring where available.
Show pharmacy object properties
Show pharmacy object properties
Enable/disable pharmacy monitoring notifications. Defaults to disabled.
Enable pharmacy data pulls at scheduled dates.
Show schedule object properties
Show schedule object properties
Enable or disable scheduled data pulls for pharmacy monitoring. When disabled, no
scheduled pulls will occur regardless of the frequency setting. Defaults to disabled.
How often scheduled data pulls should occur, can be one of
weekly or biweekly or monthly. Defaults to monthly.See scheduled queries
for timing details.
Pharmacy monitoring is coming soon! While this feature is not yet live, you can configure
your Pharmacy monitoring settings now. These settings will automatically take effect when the feature launches.
The number of patients assigned to this cohort.
Copy
Ask AI
import { MetriportMedicalApi } from "@metriport/api-sdk";
const metriport = new MetriportMedicalApi("YOUR_API_KEY");
const patientId = "00000000-0000-0000-0000-000000000000";
const result = await metriport.addPatientToCohorts(patientId, {
cohortIds: [
"00000000-0000-0000-0000-000000000000",
"11111111-1111-1111-1111-111111111111"
]
});
Copy
Ask AI
{
"cohorts": [
{
"id": "00000000-0000-0000-0000-000000000000",
"eTag": "1",
"name": "High Risk",
"description": "Patients that need frequent and robust monitoring.",
"color": "red",
"settings": {
"monitoring": {
"hie": {
"enabled": true,
"frequency": "weekly"
},
"adt": {
"enabled": true
},
"pharmacy": {
"notifications": true,
"schedule": {
"enabled": false,
"frequency": "monthly"
}
},
"laboratory": {
"notifications": true
}
}
},
"size": 150
},
{
"id": "11111111-1111-1111-1111-111111111111",
"eTag": "1",
"name": "Cardiac Care Cohort",
"description": "Patients receiving cardiac care and monitoring",
"color": "blue",
"settings": {
"monitoring": {
"hie": {
"enabled": true,
"frequency": "weekly"
},
"adt": {
"enabled": true
},
"pharmacy": {
"notifications": true,
"schedule": {
"enabled": false,
"frequency": "monthly"
}
},
"laboratory": {
"notifications": false
}
}
},
"size": 75
}
]
}
Notes
- If the patient is already in some of the specified cohorts, those will be skipped (no error thrown)
⌘I