Meal
Summary
Meal
Summary
Get user's meals
GET
/v2/summary/meal/{user_id}
x-vital-api-key*
curl --request GET \
--url https://api.tryvital.io/v2/summary/meal/{user_id} \
--header 'x-vital-api-key: <x-vital-api-key>'
curl --request GET \
--url {{BASE_URL}}/v2/summary/meal/{user_id}?start_date={{START_DATE}}&end_date={{END_DATE}} \
--header 'Accept: application/json' \
--header 'x-vital-api-key: <API_KEY>'
{
"meals": [
{
"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
},
"macros": {
"carbs": 75,
"protein": 10,
"fats": {
"saturated": 98,
"monounsaturated": 1,
"polyunsaturated": 1,
"omega3": 0,
"omega6": 0,
"total": 100
},
"sugar": 25
},
"micros": {
"minerals": {
"sodium": 500
}
}
},
"Coffee, black, 1 tbsp(s)": {
"energy": {
"unit": "kcal",
"value": 0
},
"macros": {
"carbs": 0,
"protein": 0,
"fats": {
"total": 0
},
"sugar": 0
},
"micros": {
"minerals": {
"sodium": 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"
}
]
}
All values in the returned model are supplied in the following units:
meals[*].data[*].energy.value
in calorieskcal
meals[*].data[*].macros.carbs
in gramsg
meals[*].data[*].macros.protein
in gramsg
meals[*].data[*].macros.fats.saturated
in gramsg
meals[*].data[*].macros.fats.monounsaturated
in gramsg
meals[*].data[*].macros.fats.polyunsaturated
in gramsg
meals[*].data[*].macros.fats.omega3
in gramsg
meals[*].data[*].macros.fats.omega6
in gramsg
meals[*].data[*].macros.alcohol
in litreslt
meals[*].data[*].macros.water
in litreslt
meals[*].data[*].macros.fibre
in gramsg
meals[*].data[*].macros.sugar
in gramsg
meals[*].data[*].micros.minerals
key: value pairs in milligramsmg
meals[*].data[*].micros.trace_elements
key: value pairs in milligramsmg
meals[*].data[*].micros.vitamins
key: value pairs in milligramsmg
​Path Parameters
user_idrequired
string
User id returned by vital create user id request. This id should be stored in your database against the user and used for all interactions with the vital api.
​Query Parameters
providerDefault: ""
string
Provider oura/strava etc
start_daterequired
string
Date from in YYYY-MM-DD or ISO formatted date time. If a date is provided without a time, the time will be set to 00:00:00
end_date
string
Date to YYYY-MM-DD or ISO formatted date time. If a date is provided without a time, the time will be set to 23:59:59
​Response
mealsrequired
array
curl --request GET \
--url {{BASE_URL}}/v2/summary/meal/{user_id}?start_date={{START_DATE}}&end_date={{END_DATE}} \
--header 'Accept: application/json' \
--header 'x-vital-api-key: <API_KEY>'
{
"meals": [
{
"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
},
"macros": {
"carbs": 75,
"protein": 10,
"fats": {
"saturated": 98,
"monounsaturated": 1,
"polyunsaturated": 1,
"omega3": 0,
"omega6": 0,
"total": 100
},
"sugar": 25
},
"micros": {
"minerals": {
"sodium": 500
}
}
},
"Coffee, black, 1 tbsp(s)": {
"energy": {
"unit": "kcal",
"value": 0
},
"macros": {
"carbs": 0,
"protein": 0,
"fats": {
"total": 0
},
"sugar": 0
},
"micros": {
"minerals": {
"sodium": 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"
}
]
}