Build on a weekly read of the whole body.
We're designing an API so the apps people already use can read their Soma results, with their permission. It isn't open yet. Join early access and help shape it.
GET /v1/visits/latestAuthorization: Bearer <member token>Accept: application/json{"visit": 12,"readings": {"heart_rate": { "value": 58, "unit": "bpm", "margin": 2 },"breathing_rate": { "value": 14, "unit": "/min", "margin": 1 },"grip_strength": { "value": 41.2, "unit": "kg", "margin": 1.5 },"body_fat": { "value": 18.4, "unit": "%", "margin": 2.1 },"skin_temperature": { "value": 33.9, "unit": "°C", "margin": 0.3 },"eeg_alpha_power": { "value": null, "reason": "not_measured" }Not measured this visit. Blanks stay blank.}}margin is the ± around each value. It's a draft, so names will change.Three rules the API will keep.
Only with permission
A member chooses what each app can read, and can take that access back at any time.
Every value with its margin
Each reading comes with how sure we are of it, so your app can show the range next to the number.
Blanks stay blank
If we didn't measure something, the API says so. You'll never get a zero or a guess in its place.
The API covers what the pod reads at each visit.
Working with Apple Health or Withings data today? Our open source sync layer, Open Health Sync, runs on your own server.
Run a study where the data lives.
Studies run only with members who opt in to that study. Their data stays de-identified inside a secure enclave, and your analysis runs there too, so nothing leaves.
De-identified data from members who opted in
Join early access.
Tell us what you'd build, or what you'd like to study. We read every note and write back by email.