---
title: "Body Mass Index"
method: GET
path: "/v2/timeseries/{user_id}/body_mass_index/grouped"
tags: ["timeseries"]
---

# Body Mass Index

`GET /v2/timeseries/{user_id}/body_mass_index/grouped`

## Request

- Base URL: `https://api.us.junction.com`
- URL: `https://api.us.junction.com/v2/timeseries/{user_id}/body_mass_index/grouped`
- Auth: API key in header `x-vital-api-key`

## Path parameters

- `user_id` string, uuid, required

## Query parameters

- `cursor` string, nullable: The cursor for fetching the next page, or `null` to fetch the first page.
- `next_cursor` string, nullable: The cursor for fetching the next page, or `null` to fetch the first page.
- `provider` string: Provider oura/strava etc
- `start_date` string, required: 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, nullable: 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`

Successful Response

- GroupedBodyMassIndexResponse
  - `groups` object, required: For each matching provider or lab, a list of grouped timeseries values.
  - `next` string, nullable: The cursor for fetching the next page, or `null` if there is no more data.
  - `next_cursor` string, nullable: The cursor for fetching the next page, or `null` if there is no more data.

## Other responses

- `422`: Validation Error

## Changes

- **2026-09-22** `366ac8fa8d19`: 3 warning
  - removed the optional property `groups/additionalProperties/items/source/logo` from the response with the `200` status
  - removed the optional property `groups/additionalProperties/items/source/name` from the response with the `200` status
  - removed the optional property `groups/additionalProperties/items/source/slug` from the response with the `200` status

[Operation history](https://skmtc.dev/tryvital/apis/junction-api/changes/v2/timeseries/:user_id/body_mass_index/grouped/get.md)

---

[API](https://skmtc.dev/tryvital/apis/junction-api.md) - [All operations](https://skmtc.dev/tryvital/apis/junction-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tryvital/apis/junction-api/revisions/d03cc5276c6b?raw)