Skip to main content
GET
List weigh-ins

Authorizations

__Secure-better-auth.session_token
string
cookie
required

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.

Response

200 - application/json

Weight readings, newest first.

id
integer
required

Auto-increment weight-reading identifier.

Example:

4821

ts
integer<int64>
required

Weigh-in time as a Unix epoch in milliseconds.

Example:

1782000000000

weightKg
number
required

Recorded body weight in kilograms.

Example:

72.6

bodyFatPct
number | null
required

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

Example:

17.4

note
string | null
required

Free-text note attached to the reading.

Example:

"morning, fasted"

source
string
required

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

Example:

"manual"