Skip to main content
GET
/
api
/
v1
/
sleep_timeseries
/
{user_id}
{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

​
Get Sleep Timeseries

Get sleep metrics time series data for the past n days. Returns daily sleep metrics including duration, efficiency, and quality scores.

​
Headers

ParameterTypeRequiredDescription
authorizationstringYesAPI authorization token (Bearer token)

​
Path Parameters

ParameterTypeRequiredDescription
user_idstringYesThe ID of the patient

​
Query Parameters

ParameterTypeRequiredDescription
daysintegerNoNumber of past days to fetch data for (default: 7)

​
Responses

StatusDescriptionContent Type
200Successful Responseapplication/json
422Validation Errorapplication/json

​
Sample Request

curl -X GET "https://api.covita.com/api/v1/sleep_timeseries/User1?days=7" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

​
Sample Response

{
  "user_id": "User1",
  "days": 7,
  "sleep_data": [
    {
      "date": "2023-08-15",
      "sleep_duration": 7.5,
      "sleep_efficiency": 85,
      "sleep_quality_score": 8.2,
      "bedtime": "23:00:00",
      "wake_time": "06:30:00"
    },
    {
      "date": "2023-08-14",
      "sleep_duration": 6.8,
      "sleep_efficiency": 82,
      "sleep_quality_score": 7.8,
      "bedtime": "23:30:00",
      "wake_time": "06:30:00"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
user_id
string
required

Query Parameters

​
days
integer
default:7

Response

Successful Response