curl --request GET \
--url {{BASE_URL}}/v2/summary/body/{user_id} \
--header 'Accept: application/json' \
--header 'x-vital-api-key: <API_KEY>'
{
"body": [
{
"body_mass_index": 22.3,
"bone_mass_percentage": 4.3,
"calendar_date": "2023-02-27",
"created_at": "2023-02-27T20:31:24+00:00",
"date": "2023-02-27T12:31:24+00:00",
"fat": 30,
"height": 183,
"id": "8be1306e-01fc-46b1-b5d1-a9e39052db09",
"lean_body_mass_kilogram": 40.1,
"muscle_mass_percentage": 40.2,
"source": {
"device_id": "550e8400-e29b-41d4-a716-446655440000",
"logo": "https://logo_url.com",
"name": "Withings",
"slug": "withings"
},
"updated_at": "2023-02-28T01:22:38+00:00",
"user_id": "1449752e-0d8a-40e0-9206-91ab099b2537",
"visceral_fat_index": 4.5,
"waist_circumference_centimeter": 86.36,
"water_percentage": 55.4,
"weight": 80
}
]
}Get Body summary for user_id
curl --request GET \
--url {{BASE_URL}}/v2/summary/body/{user_id} \
--header 'Accept: application/json' \
--header 'x-vital-api-key: <API_KEY>'
{
"body": [
{
"body_mass_index": 22.3,
"bone_mass_percentage": 4.3,
"calendar_date": "2023-02-27",
"created_at": "2023-02-27T20:31:24+00:00",
"date": "2023-02-27T12:31:24+00:00",
"fat": 30,
"height": 183,
"id": "8be1306e-01fc-46b1-b5d1-a9e39052db09",
"lean_body_mass_kilogram": 40.1,
"muscle_mass_percentage": 40.2,
"source": {
"device_id": "550e8400-e29b-41d4-a716-446655440000",
"logo": "https://logo_url.com",
"name": "Withings",
"slug": "withings"
},
"updated_at": "2023-02-28T01:22:38+00:00",
"user_id": "1449752e-0d8a-40e0-9206-91ab099b2537",
"visceral_fat_index": 4.5,
"waist_circumference_centimeter": 86.36,
"water_percentage": 55.4,
"weight": 80
}
]
}curl --request GET \
--url {{BASE_URL}}/v2/summary/body/{user_id} \
--header 'Accept: application/json' \
--header 'x-vital-api-key: <API_KEY>'
Vital Team API Key
Provider oura/strava etc Provider oura/strava etc
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 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
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 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
Successful Response
Show child attributes
User id returned by vital create user request. This id should be stored in your database against the user and used for all interactions with the vital api.
Date of the specified record, formatted as ISO8601 datetime string in UTC 00:00. Deprecated in favour of calendar_date.
Date of the summary in the YYYY-mm-dd format.
Source summarizes where a sample or a summary is sourced from. At minimum, the source provider is always included.
Show child attributes
Provider slug. e.g., oura, fitbit, garmin.
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
The identifier of the app which recorded this summary. This is only applicable to multi-source providers like Apple Health and Android Health Connect.
The identifier of the device which recorded this summary.
For workout stream timeseries, this is the standard sport slug of the workout with which the timeseries data are associated.
For the distance timeseries, this is wheelchair_pushing if the user is a wheelchair user, or null otherwise.
For all summary types and non-workout timeseries, this is always null.
For workout stream timeseries, this is the workout ID with which the timeseries data are associated.
For all other types, this is always null.
Deprecated. Subject to removal after 1 Jan 2024.
Deprecated. Use provider instead. Subject to removal after 1 Jan 2024.
Deprecated. Subject to removal after 1 Jan 2024.
{ "provider": "oura", "type": "ring" }Weight in kg::kg
Total body fat percentage::perc
Water percentage in the body::perc
Muscle mass percentage in the body::perc
Visceral fat index::scalar
Bone mass percentage in the body::perc
Was this page helpful?