⌘K
Sign upSign in

Prime Wearables & Biometrics API

Wearable device telemetry ingestion, canonical FHIR observation normalization, and readiness alerting

Vendors

9

Integrated platforms

Biometrics

7+

Canonical metrics

Output

FHIR

R4 Observations

LOINC

Coded

Standard terminology

Live API Status — Prime Wearables

Probing production endpoints…

Rate Limits & SLA

Rate limit

2,000 events/min

Burst

100 req/sec

Uptime SLA

99.9%

Support

Business hours · 4h

P95 latency

< 350ms ingest

Retention

3 years biometrics

Supported Wearable Vendors

VendorDevice ModelsSupported MetricsStatus
OuraRing Gen3/Gen4
HRVResting HRSpO2SleepTemperature
Active
WHOOPWHOOP 4.0
HRVResting HRSpO2SleepStrainRecovery
Active
GarminFenix/Venu/Forerunner
HRVResting HRSpO2SleepBody BatteryStress
Active
Apple HealthApple Watch Series
HRVResting HRSpO2SleepVO2 MaxRespiratory Rate
Active
FitbitSense/Charge/Versa
HRVResting HRSpO2SleepStress
Active
PolarVantage/Ignite/Grit
HRVResting HRSleepTraining LoadRecovery
Active
DexcomG7/Stelo
Continuous GlucoseTime in RangeVariability
Active
CorosVERTIX/PACE/APEX
HRVResting HRSpO2SleepTraining Status
Active
Samsung HealthGalaxy Watch
HRVResting HRSpO2SleepBody Composition
Active

Canonical Biometric Metrics

hrv_rmssd

Heart Rate Variability (RMSSD)

Unit: msLOINC: 80404-7
resting_hr

Resting Heart Rate

Unit: /minLOINC: 40443-4
spo2

Oxygen Saturation

Unit: %LOINC: 59408-5
sleep_total

Total Sleep Duration

Unit: minLOINC: 93832-4
sleep_deep

Deep Sleep Duration

Unit: minLOINC: 93831-6
sleep_rem

REM Sleep Duration

Unit: minLOINC: 93830-8
sleep_efficiency

Sleep Efficiency Score

Unit: %LOINC: 93829-0

Prime API Endpoints

POST
/prime/v1/wearables/eventsOAuth

Ingest Wearable Telemetry

95ms/250ms120/min202
GET
/prime/v1/wearables/events/{ingestionId}OAuth

Check Normalization Status

35ms/90ms120/min200
POST
/prime/v1/fhir/ObservationOAuth

Submit Prime Observation

120ms/300ms60/min201
PUT
/prime/v1/fhir/Device/{deviceIdentityHash}OAuth

Upsert Device Provenance

100ms/250ms30/min200
GET
/prime/v1/fhir/FlagOAuth

Get Readiness Alerts

80ms/200ms60/min200

Integration toolkit

SandboxAPI PlaygroundOpenAPI Try-it-outCertificationWebhooks
Postman collection (6 requests)Import the same JSON into Insomnia

Official SDKs

Generate TypeScript client →·Python →·All SDKs

Apex Prime certification track

12 required items · platform + product-specific checks

Full checklist →
  • First authenticated API call in sandbox
  • OAuth or API key with least-privilege scopes
  • FHIR R4 read against sandbox lake
  • GPID boundary headers on write paths
  • Webhook HMAC-SHA256 verification implemented
  • Webhook idempotency by delivery ID

+9 more on the certification page

Complete all required items before production go-live

Webhook events for Apex Prime

Subscribe at /webhooks — verify HMAC-SHA256 signatures

Event catalog →
prime.ingest.persistedPrime Wearables

Wearable telemetry normalized to FHIR Observations.

{
  "event": "prime.ingest.persisted",
  "ingestion_id": "ing_def456",
  "observation_count": 4,
  "athlete_gpid": "APX-1A2B3C4D",
  "source": "oura"
}
prime.readiness.alertPrime Wearables

Readiness flag triggered from biometric thresholds.

{
  "event": "prime.readiness.alert",
  "flag": "recovery_low",
  "severity": "warning",
  "athlete_gpid": "APX-1A2B3C4D",
  "metric": "hrv_rmssd",
  "value": 28.5
}