Each sample is uniquely identified by a triple key (3-tuple) comprising of its resource type name, its source (ID or slug) and its timestamp. e.g., (heartrate, fitbit, 2023-01-23T12:34:56Z).

If multiple samples are received at the same triple key, the last sample received replaces all its previous versions.

Properties

event_type
const string
required

Constant: daily.data.heartrate.updated

data
TimeseriesData
required
data
ClientFacingTimeseries[]
required
id
integer | null

Deprecated

timezone_offset
integer | null

Time zone UTC offset in seconds. Positive offset indicates east of UTC; negative offset indicates west of UTC; and null indicates the time zone information is unavailable at source.

type
string | null

The reading type of the measurement. This is applicable only to Cholesterol, IGG and IGE.

unit
string
required

The unit of the value. We use SI units where possible, e.g. mmol/L for glucose/cholesterol, bpm for heart rate, etc.

timestamp
string
required

The timestamp of the measurement.

value
number
required

The value of the measurement.

source_id
integer
required
source
ClientFacingProvider
required

[⚠️ Deprecated] Deprecated. Use provider instead. Subject to removal after 1 Jan 2024.

name
string
required

Name of source of information

slug
string
required

Slug for designated source

logo
string
required

URL for source logo

provider
ClientFacingProvider
required
name
string
required

Name of source of information

slug
string
required

Slug for designated source

logo
string
required

URL for source logo

user_id
string
required

Examples

{
  "event_type": "daily.data.heartrate.updated",
  "data": {
    "data": [
      {
        "timestamp": "2023-11-30T12:32:39.899054+00:00",
        "timezone_offset": null,
        "value": 70,
        "type": null,
        "unit": "bpm"
      }
    ],
    "source_id": 1,
    "provider": {
      "name": "Oura",
      "slug": "oura",
      "logo": "https://logo_url.com"
    },
    "user_id": "350bc912-0977-4768-952f-0384afa0df4c"
  }
}