Vekta API
Metrics

List a user's metrics

Full history of the user's body and performance metrics, ordered by date, optionally restricted to a date range. Responds with 404 if the user does not exist or is not accessible to you.

GET
/users/{userId}/metrics

Authorization

bearer
AuthorizationBearer <token>

Vekta api key, e.g. Authorization: Bearer vk_...

In: header

Path Parameters

userId*string

Id of a user you have access to (see GET /users), or the special value me for the user owning the api key

Query Parameters

from?string

Inclusive start of the date range (YYYY-MM-DD)

Formatdate
to?string

Inclusive end of the date range (YYYY-MM-DD)

Formatdate

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/users/me/metrics"
[  {    "id": "mtr_01JK4W2N9XQ3F5H7B8C6D2E9GT",    "type": "weight",    "value": 71.5,    "unit": "kg",    "source": "user",    "date": "2026-08-01",    "sport": "global"  }]

List a user's events GET

The user's planned events and races, most recent first, optionally restricted to a date range. Responds with 404 if the user does not exist or is not accessible to you.

List a user's sleeps GET

The user's recorded nights of sleep, most recent first, optionally restricted to a date range matching the day field. Responds with 404 if the user does not exist or is not accessible to you.