Submitting Summaries to Inform Connect

The summaries resource is a daily aggregate of activity data for a given user and a specific source.

summaries is designed to record daily aggregates or summarizations (data points that accumulate throughout the day - e.g., steps, distance walked, average heart rate throughout the day, etc).

A user will only have one daily summaries per Data Source for a given day.

📘

There must only be one summary record per Data Source per day.

The summaries record should be updated throughout the day to reflect changes to the summarized metrics as the day progresses.

Alternatively, it can be submitted to Inform Connect the day after if you want to reconcile data before sending it through. However, if you plan to hold the summaries record, be aware that most other sources do not do this and Validic Clients have a strong preference for receiving the data as quickly as possible and expect updates will occur to the summaries data throughout the day.


Example Summaries POST

{
    "log_id": "validic-test-summary-record-1",
    "start_time": "2025-02-24T12:30:09Z",
    "end_time": "2025-02-24T12:30:09Z",
    "utc_offset": -18000,
    "offset_origin": "source",
    "metrics": [
        {
                    "type": "active_duration",
                    "origin": "device",
                    "unit": "s",
                    "value": 2820.0
                },
                {
                    "type": "active_energy_burned",
                    "origin": "device",
                    "unit": "kcal",
                    "value": 809.0
                },
                {
                    "type": "basal_energy_burned",
                    "origin": "device",
                    "unit": "kcal",
                    "value": 993.0
                },
                {
                    "type": "distance",
                    "origin": "device",
                    "unit": "m",
                    "value": 4390.0
                },
                {
                    "type": "energy_burned",
                    "origin": "device",
                    "unit": "kcal",
                    "value": 1686.0
                },
                {
                    "type": "steps",
                    "origin": "device",
                    "unit": "count",
                    "value": 6392
                },
                {
                    "type": "resting_heart_rate",
                    "origin": "device",
                    "unit": "bpm",
                    "value": 70
                }
    ],
    "source": {
        "type": "validic_connect_test",
        "device": {
            "id": null,
            "model": "Validic Watch",
            "manufacturer": "Validic Inc."
        }
    },
    "type": "summary",
    "version": "1.0"
}