Skip to content
skcal
Esc
↑↓navigate↵open⌘Jpreview

List weigh-ins

Returns up to 365 of the caller’s most recent weight readings, newest first.

GET/api/weight
Authorization
__Secure-better-auth.session_tokenAPI key · cookierequired

Better Auth session. Signing in (Google or email magic link) sets an HttpOnly session cookie that scopes every request to that account. The web app and CLI use this; agents use the OAuth 2.1 flow of the MCP server.

or
AuthorizationBearer token · headerrequired

Personal API key sent as Authorization: Bearer skcal_…. Create and scope keys in the app under your profile → API keys. Keys default to full access; a scoped key is limited to its granted resource:action permissions and cannot manage other keys.

Responses
200

Weight readings, newest first.

Array of WeightReading
idintegerrequired

Auto-increment weight-reading identifier.

tsinteger<int64>required

Weigh-in time as a Unix epoch in milliseconds.

weightKgnumberrequired

Recorded body weight in kilograms.

bodyFatPctnumber | nullrequired

Body-fat percentage, if recorded (noisy on consumer scales).

notestring | nullrequired

Free-text note attached to the reading.

sourcestringrequired

Where the reading came from, e.g. manual or scale.

Try it
Server
Authorization
Request
curl -X GET 'https://app.skcal.fit/api/weight' \
  -H 'Cookie: __Secure-better-auth.session_token=YOUR_API_KEY' \
  -H 'Accept: application/json'
Response
[
  {
    "id": 4821,
    "ts": 1782000000000,
    "weightKg": 72.6,
    "bodyFatPct": 17.4,
    "note": "morning, fasted",
    "source": "manual"
  }
]

Was this page helpful?