Skip to content
GET /v1/wake-time

Recommended wake times from a bedtime

Try it live

10 free calls per day — no sign-up, no API key. Goes through the oanor gateway.

Custom headers (optional)
api.oanor.com/sleep-api

It works. Grab an API key and use it in your project.

Get an API key

Code snippets

curl "https://api.oanor.com/sleep-api/v1/wake-time" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/sleep-api/v1/wake-time", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/sleep-api/v1/wake-time");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/sleep-api/v1/wake-time",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "advice": "If you go to bed now, wake at one of these times to rise at the end of a sleep cycle.",
        "bedtime": {
            "time_12h": "10:00 PM",
            "time_24h": "22:00",
            "minute_of_day": 1320
        },
        "asleep_at": {
            "time_12h": "10:15 PM",
            "time_24h": "22:15",
            "minute_of_day": 1335
        },
        "disclaimer": "Informational only — sleep needs vary by individual; not medical advice.",
        "wake_times": [
            {
                "cycles": 3,
                "quality": "short",
                "wake_at": {
                    "time_12h": "2:45 AM",
                    "time_24h": "02:45",
                    "minute_of_day": 165
                },
                "sleep_hours": 4.5,
                "sleep_duration": "4h 30m"
            },
            {
                "cycles": 4,
                "quality": "minimum recommended",
                "wake_at": {
                    "time_12h": "4:15 AM",
                    "time_24h": "04:15",
                    "minute_of_day": 255
                },
                "sleep_hours": 6,
                "sleep_duration": "6h"
            },
            {
                "cycles": 5,
                "quality": "good",
                "wake_at": {
                    "time_12h": "5:45 AM",
                    "time_24h": "05:45",
                    "minute_of_day": 345
                },
                "sleep_hours": 7.5,
                "sleep_duration": "7h 30m"
            },
            {
                "cycles": 6,
                "quality": "ideal",
                "wake_at": {
                    "time_12h": "7:15 AM",
                    "time_24h": "07:15",
                    "minute_of_day": 435
                },
                "sleep_hours": 9,
                "sleep_duration": "9h"
            }
        ],
        "fall_asleep_minutes": 15,
        "cycle_length_minutes": 90
    },
    "meta": {
        "timestamp": "2026-06-03T17:42:01.960Z",
        "request_id": "8b04277d-346b-450d-8924-4b3cdc3bd39b"
    },
    "status": "ok",
    "message": "Recommended wake times",
    "success": true
}