Each summary object is uniquely identified by its id.

If multiple events are received at the same id, the last event received replaces all its previous versions.

​
Properties

event_type
const string
required

Constant: daily.data.meal.created

data
MealInDBBase_ClientFacingSource_
required
id
string
required
user_id
string
required
priority_id
integer
required
source_id
integer
required
provider_id
string
required
timestamp
string
required
name
string
required
energy
Energy | null
unit
string
required
value
number
required
macros
Macros | null
carbs
number | null

Amount of carbohydrates in grams (g)

protein
number | null

Amount of protein in grams (g)

fats
Fats | null

Details of fat content

saturated
number | null

Amount of saturated fats in grams (g)

monounsaturated
number | null

Amount of monounsaturated fats in grams (g)

polyunsaturated
number | null

Amount of polyunsaturated fats in grams (g)

omega3
number | null

Amount of Omega-3 fatty acids in grams (g)

omega6
number | null

Amount of Omega-6 fatty acids in grams (g)

total
number | null

Total amount of fats in grams (g)

alcohol
number | null

Amount of alcohol in grams (g)

water
number | null

Amount of water in grams (g)

fibre
number | null

Amount of dietary fiber in grams (g)

sugar
number | null

Amount of sugar in grams (g)

micros
Micros | null
minerals
object | null

Amount of each mineral in grams (g)

trace_elements
object | null

Amount of each trace element in grams (g)

vitamins
object | null

Amount of each vitamin in grams (g)

data
object | null
source
ClientFacingSource
required
provider
string
required

Provider slug. e.g., oura, fitbit, garmin.

type
string | null

The type of the data source (app or device) by which the summary or the timeseries data were recorded. This defaults to unknown when Vital cannot extract or infer that information

app_id
string | null

The identifier of the app which recorded this summary. This is only applicable to multi-source providers like Apple Health and Android Health Connect.

name
string
required

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

slug
string
required

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

logo
string
required

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

created_at
string
required
updated_at
string
required

​
Examples

{
  "event_type": "daily.data.meal.created",
  "data": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5",
    "priority_id": 42,
    "source_id": 10,
    "provider_id": "123456",
    "timestamp": "2019-08-24T14:15:22Z",
    "name": "Dinner",
    "data": {
      "Chiken coquet starter": {
        "energy": {
          "unit": "kcal",
          "value": 400.0
        },
        "macros": {
          "carbs": 75.0,
          "protein": 10.0,
          "fats": {
            "saturated": 98,
            "monounsaturated": 1,
            "polyunsaturated": 1,
            "omega3": 0,
            "omega6": 0,
            "total": 100
          },
          "sugar": 25.0
        },
        "micros": {
          "minerals": {
            "sodium": 500.0
          }
        }
      },
      "Coffee, black, 1 tbsp(s)": {
        "energy": {
          "unit": "kcal",
          "value": 0.0
        },
        "macros": {
          "carbs": 0.0,
          "protein": 0.0,
          "fats": {
            "total": 0.0
          },
          "sugar": 0.0
        },
        "micros": {
          "minerals": {
            "sodium": 0.0
          }
        }
      }
    },
    "source": {
      "name": "MyFitnessPal",
      "slug": "my_fitness_pal",
      "logo": "https://logo_url.com"
    },
    "created_at": "2019-08-24T14:15:22Z",
    "updated_at": "2019-08-24T14:15:22Z"
  }
}
historical.data.weight.createddaily.data.meal.updated