Skip to main content
GET
Home-screen snapshot

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.

Query Parameters

date
string<date>

Day to report nutrition for (YYYY-MM-DD). Defaults to the server's current UTC date.

Response

200 - application/json

The dashboard snapshot.

Everything the home screen needs in a single response.

weight
object
required

Latest-weight summary for the dashboard card.

Example:
targets
object
required

The user's current goals shown on the dashboard.

Example:
measurementsLatest
object[]
required

Latest value per measured site.

Example:
shoulderToWaist
number | null
required

Shoulder-to-waist ratio (V-taper metric).

Example:

1.497

nutritionToday
object | null
required

Today's nutrition totals, or null if nothing is logged.

Example: