Get a trainee's body measurements (GET /api/public/trainees/{traineeId}/measurements)

A trainee's body measurements: weight history, body-fat history, circumference history, and custom measurement types. Every series is returned in full unless you narrow it with from/to or latest, which apply to all series at once. Not paginated: the response is many parallel dated series rather than one list, so a page number has no coherent meaning across them.

Authentication

Requires an API key, sent as Authorization: Bearer cp_live_....

API keys carry scopes. Get the catalog of scopes and webhook events lists every scope.

Path parameters

Path parameters
Name	Type	Description
`traineeId`required	`string`

Query parameters

Query parameters
Name	Type	Description
`from`	`string`	Only entries measured on or after this date (YYYY-MM-DD).
`to`	`string`	Only entries measured on or before this date (YYYY-MM-DD).
`latest`	`integer`	Keep only the most recent N entries of each series, applied after from/to. Use it to ask for a recent trend without pulling years of history. Minimum: `1` Maximum: `500`

Request examples

cURL

curl --request GET \
  --url 'https://api.coach-platform.com/api/public/trainees/<traineeId>/measurements' \
  --header 'Authorization: Bearer cp_live_...'

JavaScript (fetch)

const response = await fetch('https://api.coach-platform.com/api/public/trainees/<traineeId>/measurements', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer cp_live_...',
  },
});

const data = await response.json();

Responses

`200` OK

Example body (application/json)

{
  "data": {}
}

Response fields (1)

Response fields
Name	Type	Description
`data`	`object`

This page is also available as Markdown. Browse it in the interactive explorer or download the OpenAPI spec.