Results
Understand the vital signs result object, units, confidence scoring, and interpretation.
Vital signs results are returned to your application after a measurement completes. SDKs poll GET /sdk/session/{sessionId}/result after upload completion. Circadify does not retain results: a completed result stays retrievable for up to 24 hours after completion, after which the stored vitals are purged and the result endpoint returns 410 Gone. If your application needs a history, persist the result in your own database.
Result Object
{
"session_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"status": "completed",
"vitals": {
"heart_rate": 72,
"respiratory_rate": 16,
"hrv": 45.2,
"spo2": 98.1,
"systolic_bp": 122,
"diastolic_bp": 78,
"confidence": 0.87
},
"completed_at": "2026-05-24T18:01:14.200Z"
}Vital Signs Fields
| Field | Type | Unit | Description |
|---|---|---|---|
heart_rate | number | BPM | Heart rate in beats per minute |
respiratory_rate | number | breaths/min | Respiratory rate in breaths per minute |
hrv | number | ms | Heart rate variability in milliseconds |
spo2 | number | % | Blood oxygen output, when enabled |
systolic_bp | number | mmHg | Systolic blood pressure trend, when enabled |
diastolic_bp | number | mmHg | Diastolic blood pressure trend, when enabled |
confidence | number | 0-1 | Measurement reliability score |
The confidence score applies to the measurement as a whole. Optional fields may be absent when they are not enabled for the account, SDK, device, or intended use.
Typical Ranges
These are general adult reference ranges. They are included for display context only and are not clinical thresholds.
| Vital | Typical Range |
|---|---|
| Heart Rate | 60-100 BPM |
| Respiratory Rate | 12-20 breaths/min |
| HRV | 20-100 ms |
| SpO2 | 95-100% |
| Systolic BP | 90-140 mmHg |
| Diastolic BP | 60-90 mmHg |
Confidence Score
The confidence field indicates measurement reliability on a scale from 0.0 to 1.0:
| Range | Meaning | Recommendation |
|---|---|---|
0.7-1.0 | High confidence | Results are reliable for most use cases |
0.4-0.7 | Moderate confidence | Results may benefit from a re-scan |
0.0-0.4 | Low confidence | Prompt the user to retry under better conditions |
Do not treat a low-confidence result as a failed clinical measurement. Prompt the user to repeat the scan and show appropriate workflow-specific disclaimers.
Metric Availability
Heart rate, respiratory rate, and HRV are standard outputs. BP, SpO2, and other metrics are configuration-dependent. See Metric Availability for the full matrix.
Result Availability
Results are returned to your application and are purged from Circadify's side after a 24-hour retention window (the result endpoint answers 410 Gone afterwards). Your application should handle and persist the result immediately.
If processing fails, the result endpoint returns a failed status and an error message. SDKs surface that failure as CircadifyError.