Vekta API
Events

List a user's events

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.

GET
/users/{userId}/events

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/events"
[  {    "id": "evt_01JK4W2N9XQ3F5H7B8C6D2E9GT",    "name": "Gran Fondo",    "description": null,    "date": "2026-09-14",    "time": "09:30:00",    "sport": "cycling",    "subSport": "road",    "distance": 120000,    "elevationGain": 2400,    "duration": 18000,    "work": 3200,    "carbIntake": 60,    "activityId": null  }]

List a user's notes GET

The user's notes, most recent first, optionally restricted to a date range. Notes hidden until a future date are only returned to their creator. Responds with 404 if the user does not exist or is not accessible to you.

List a user's metrics GET

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.