Life OS, the first piece of ELO, is live on the App Store in 174 countries →
Developers

Your Life OS data,in your own code.

A read only REST API over your own account: days, sleep, meals, workouts and today's list. You switch it on, choose what it may read, and make a key. Nothing is shared until you do.

On this page
Browse the API

Quick start

  1. In Life OS, open Settings, Your data, Developer API and switch it on.
  2. Choose what the API may read: days, sleep, meals, workouts, today's list. Each is off until you switch it on.
  3. Tap Create a key. It is shown once: keep it somewhere safe, such as an environment variable called ELO_KEY.
  4. Ask for your last 30 days:
curl "https://api.eloai.io/v1/days" \
  -H "Authorization: Bearer $ELO_KEY"

Your iPhone keeps a copy of what you chose, for the last 90 days, where the API can read it, and refreshes it as the app is used. Turn the API off and that copy and every key are deleted.

Authentication

Send your key as a bearer token on every request: Authorization: Bearer elo_.... Keys start with elo_ and are stored by us only as a hash. Anyone holding your key can read what you shared, so keep it on a server or in your own scripts, never in a web page or an app you give to others. Revoke a key in the same screen; it stops working at once.

Base URL and dates

https://api.eloai.io/v1. Every response is JSON. Dates are ISO 8601 in your own time zone (see timeZone on /v1/me). from and to take YYYY-MM-DD, both inclusive; without them you get the last 30 days. A figure the phone did not have is null, never zero.

GET /v1/me

The account the key belongs to, what it may read, and when your iPhone last sent a copy.

{
  "account": "a1b2c3d4",
  "name": "Sky",
  "scopes": ["days", "sleep", "meals"],
  "timeZone": "Asia/Jerusalem",
  "syncedAt": "2026-10-05T04:02:11.000Z"
}

GET /v1/days?from=2026-09-01&to=2026-09-30

One row a day. Needs the days scope.

FieldTypeWhat it is
datestringThe day, YYYY-MM-DD, in your time zone.
sleepMinutesnumber | nullMinutes asleep the night that ended that morning.
readinessnumber | nullReadiness, 0 to 100, against your own normal.
restingHeartRatenumber | nullResting heart rate, beats a minute.
hrvnumber | nullHeart rate variability (SDNN), milliseconds.
stepsnumber | nullSteps that day.
activeKcalnumber | nullActive energy, kilocalories.
exerciseMinutesnumber | nullExercise minutes.
waterMlnumber | nullWater logged, millilitres.
eatenKcalnumber | nullEnergy eaten, kilocalories.
proteinG, carbsG, fatGnumber | nullMacronutrients eaten, grams.
{ "days": [ { "date": "2026-09-30", "sleepMinutes": 431, "readiness": 64, "restingHeartRate": 52, "hrv": 61,
  "steps": 9120, "activeKcal": 512, "exerciseMinutes": 38, "waterMl": 1750,
  "eatenKcal": 2140, "proteinG": 142, "carbsG": 210, "fatG": 71 } ] }

GET /v1/sleep?from&to

One row a night. Needs the sleep scope.

FieldTypeWhat it is
nightstringThe night, YYYY-MM-DD of the evening it began.
asleepMinutesnumberTotal minutes asleep.
deepMinutes, remMinutes, coreMinutesnumber | nullMinutes in each stage.
awakeMinutesnumber | nullMinutes awake in the night.
midpointHournumber | nullThe middle of your sleep, hours after midnight.
respiratoryRatenumber | nullBreaths a minute, asleep.

GET /v1/meals?from&to

Each meal and drink you logged. Needs the meals scope.

FieldTypeWhat it is
timestringWhen it was logged, ISO 8601 with your offset.
namestringWhat it was.
kcalnumber | nullEnergy, kilocalories.
proteinG, carbsG, fatGnumber | nullGrams of each.
drinkMlnumber | nullMillilitres, for a drink.

GET /v1/workouts?from&to

Each workout from Apple Health. Needs the workouts scope.

FieldTypeWhat it is
typestringThe workout, as Apple Health names it.
startstringWhen it began, ISO 8601 with your offset.
minutesnumberHow long it lasted.
activeKcalnumber | nullActive energy, kilocalories.

GET /v1/tasks

Today's list. Needs the tasks scope. Takes no dates.

FieldTypeWhat it is
titlestringThe item on today's list.
timestring | nullIts time, HH:MM, when it has one.
donebooleanWhether it was ticked off.

Limits

  • 60 requests a minute for each key.
  • Up to 5 keys on an account at once.
  • The last 90 days are kept; at most 2,000 rows come back from one request, oldest first. Ask for a shorter range to page.

Errors

Every error is JSON: {"error": "code", "message": "what to do"}.

StatuserrorMeaning
400bad rangefrom is after to.
401unauthorizedNo key, a key that was revoked, or the API is switched off.
403not sharedThat data is not shared with the API. Switch it on in the app.
404not foundNo such endpoint.
405method not allowedThe API is read only. Use GET.
429rate limitedMore than 60 requests a minute. Wait and try again.
503unavailableA moment's trouble on our side. Try again shortly.

What it can see

Only what you switched on, only yours, and only read. The API cannot change your data, cannot see your journal, notes or conversations with your ELO, and is never used for advertising. See the API terms and the privacy policy.