Skip to main content
GET
List meals for a day

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 list (YYYY-MM-DD). Defaults to the server's current UTC date.

Response

200 - application/json

Meals for the day, newest first.

id
string<uuid>
required

Meal identifier.

Example:

"3f8b1c2a-5d6e-4f70-8a1b-2c3d4e5f6071"

note
string | null
required

Meal note or the original text description.

Example:

"lunch at the office"

createdAt
integer<int64>
required

Meal creation time as a Unix epoch in milliseconds.

Example:

1782000000000

photoKeys
string[]
required

R2 object keys of the meal's photos.

Example:
items
object[]
required

Food items in the meal.

Example: