/wellness namespace · APlicious

Sleep tracker API — cycles, quality scoring, and optimal wake times

Three endpoints cover sleep: /wellness/sleep-cycle for optimal bedtimes, /wellness/sleep-quality for a scored quality assessment from bedtime/wake/interruptions data, and /wellness/circadian for daily peak performance windows.

3sleep-related endpoints

Get free API key View docs

GET /api/v1/wellness/sleep-cycle

const res = await fetch(
  'https://aplicious.com/api/v1/wellness/sleep-cycle?wake_time=07:00&cycles=5',
  { headers: { 'X-API-Key': 'lapi_live_••••' } }
);
const { data } = await res.json();
// { wake_time: "07:00", cycles: 5, bedtime: "23:30",
//   total_sleep_mins: 450, tip: "Aim to be in bed by 23:15 to fall asleep by 23:30" }

No credit card · Free to start · X-API-Key header auth

What's included in /wellness

Optimal sleep cycle times

GET /wellness/sleep-cycle?wake_time=07:00&cycles=5 returns the exact bedtime to complete 5 full 90-minute cycles.

Sleep quality scoring

POST to /wellness/sleep-quality with bedtime, wake time, interruptions, and age for a 0–100 quality score and improvement tips.

Circadian rhythm windows

GET /wellness/circadian?wake_time=07:00 returns peak focus, exercise, and wind-down windows for the day.

No wearable required

All endpoints work from user-reported data — no device integration, no OAuth, no hardware dependency.

Pairs with /wellness/stress

Combine sleep quality with the 5-factor stress score for a complete daily recovery dashboard.

Start using the sleep tracker API today

Free tier — 250 calls/month, no credit card. Upgrade when you need more.

Get free API key Explore /wellness docs

Frequently asked questions

What is a sleep cycle?

A complete sleep cycle is approximately 90 minutes, moving through light, deep, and REM sleep. Waking at the end of a cycle feels more refreshing than mid-cycle.

What inputs does sleep-quality need?

bedtime (HH:MM), wake_time (HH:MM), interruptions (count), and age (5–110 — required).

Is this accurate without a wearable?

It uses reported inputs, so accuracy depends on self-reporting. For validated medical sleep data, integrate a wearable's API alongside this endpoint.

Related API guides

One key unlocks all 10 namespaces — finance, legal, property, jobs, wellness, and more.

View all plans and pricing →