Description
Provides access to aggregated and de-identified population health trends at the country and global levels, including demographics, vital signs, health status, and comprehensive clinical assessments such as diagnoses and prevalence.
Endpoint
https://app.myhealthnote.com/api/fhir/Dash/patient/Trends
Request Examples
cURL
curl -X GET \
"https://app.myhealthnote.com/api/fhir/Dash/patient/Trends" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Accept: application/json"JavaScript/Node.js
const response = await fetch("https://app.myhealthnote.com/api/fhir/Dash/patient/Trends", {
headers: {
"Authorization": "Bearer YOUR_ACCESS_TOKEN",
"Accept": "application/json"
}
});
const data = await response.json();
console.log(data);Python
import requests
response = requests.get(
"https://app.myhealthnote.com/api/fhir/Dash/patient/Trends",
headers={
"Authorization": "Bearer YOUR_ACCESS_TOKEN",
"Accept": "application/json"
}
)
print(response.json())
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
country |
string | No | - | ISO2 country code (e.g., US, KE). Omit or use "XX" for global trends |
days |
integer | No | 30 | Number of days of data to retrieve (max 365) |
calculationType |
string | No | - | Type of calculation: demographics, vital_signs, health_status, comprehensive |
startDate |
string | No | - | Start date (YYYY-MM-DD format) |
endDate |
string | No | - | End date (YYYY-MM-DD format) |
limit |
integer | No | 100 | Maximum number of records to return |
offset |
integer | No | - | Offset for pagination |
Response Example
{
"success": true,
"data": {
"vital_signs": [
{
"timestamp": "2024-01-12T13:40:51.521Z",
"country": "KE",
"patientCount": 1500,
"averages": {
"heartRate": 72.5,
"bodyTemp": 36.8,
"bloodGlucose": 95.2,
"systolicBP": 122,
"diastolicBP": 78
},
"distributions": {
"heartRate": {
"normal": 65,
"elevated": 25,
"high": 10
}
},
"alerts": {
"emergency": 5,
"unwell": 45
}
}
]
},
"metadata": {
"query": {
"country": "KE",
"days": 30,
"calculationType": "all",
"limit": 50,
"offset": 0
},
"stats": {
"totalRecords": 50,
"dateRange": {
"start": "2023-12-13T13:40:51.521Z",
"end": "2024-01-12T13:40:51.521Z",
"daysCovered": 30
},
"patientCount": 75000,
"countries": [
"KE"
],
"calculationTypes": [
"vital_signs",
"demographics"
]
}
}
}
Try It Out
Enter your API token to test this endpoint:
