Get Data Timeline
Changed onReturns when a user has data, as counts per time bucket.
Buckets are truncated in UTC and only non-empty ones are returned, so the response is sparse: the caller fills the gaps for the window it asked for. Counts cover both the live and the archive table, so archived history does not read as missing data.
Optionally scope to a window via start_date / end_date (by recorded_at); omitting both returns the user's whole history.
Request
- Base URLhttps://api.openwearables.io (the document declares no server; this is the origin it was published from)
- AuthOAuth 2PasswordToken URL/api/v1/auth/login
Path parameters
Query parameters
ISO 8601 datetime (e.g. 2023-11-07T05:31:56Z) or Unix timestamp in seconds. Date-only strings (e.g. 2023-11-07) are also accepted and cover the whole day, so a date-only range includes both boundary days.
ISO 8601 datetime (e.g. 2023-11-07T05:31:56Z) or Unix timestamp in seconds. Date-only strings (e.g. 2023-11-07) are also accepted and cover the whole day, so a date-only range includes both boundary days.
Width of one bucket in a per-user data timeline.
Bucket width.
What a timeline series is keyed by.
What each series counts.
Supported data providers.
Headers
Response
Successful Response
Changes
- breaking
the
response's property type changed fromarraytostringfor status - info
media type
application/jsonwas changed to a more specific media typeapplication/problem+jsonfor the response status - info
the response property
became required for the status - info
added the required property
to the response with the status - info
added the required property
to the response with the status - info
added the required property
to the response with the status - info
added the required property
to the response with the status
- breaking
- warning
added the new
workout_typeenum value to theresponse property for the response status - warning
added the new
workoutsenum value to the//response property for the response status - info
added the new optional
queryrequest parameterprovider - info
added the new enum value
workout_typeto thequeryrequest parametergroup_by
- warning