Meal
Summary
Get user's meals
GET
/v2/summary/meal/{user_id}
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
Query Parameters
provider
Default: ""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
200 - application/json
mealsrequired
object[]
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"
}
]
}