GET
/api/v1/households/{householdId}/home/todayRead the day as Home shows it: dinner, timing, calendar, shopping, questions
date defaults to the household's local today. Any member, a Junior included; the questions say which of them need an adult to answer. Not a pure read: opening the day makes sure, idempotently, that the household has one conversation for this date with Bryti's morning message at the top, and the response names both (#1888, ADR-162). A date far outside the calendar a household lives in answers 400. Not free either: the day may ask the model for a dish that uses up what is about to go off, so the read is rate-limited per household — 120 a minute by default, and over the ceiling answers 429 with a Retry-After header.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
householdId | path | string (uuid) | Required | — |
date | query | string (date) | — | — |
Responses
- 200OK
application/jsonHomeTodayResponse- 400Bad Request
application/problem+jsonProblemDetails- 401No session, or the session is no longer valid.
application/problem+jsonProblemDetails- 404Not Found
application/problem+jsonProblemDetails- 426The build named in X-App-Version is below its platform's version floor (ADR-070). Problem type app-version-unsupported; the only way forward is the store. Callers without the header are never turned away.
application/problem+jsonProblemDetails- 429Too Many Requests
application/problem+jsonProblemDetails- Headers
Retry-After- — Seconds to wait when a rate limit answered, or an HTTP date when the household's AI is paused. Absent when the household's AI quota for the period is used up — that resets by itself.
Example
curl -b "bryti_session=…" \
"https://bryti.app/api/v1/households/3fa85f64-5717-4562-b3fc-2c963f66afa6/home/today"Example response
200
application/json{
"date": "2026-09-07",
"conversationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"morningMessageId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"dinnerTime": "string",
"dinnerTimeSource": "HouseholdDefault",
"planId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"tonight": {
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"date": "2026-09-07",
"entryType": {},
"isLocked": false,
"portions": 0,
"candidate": {}
},
"events": [
{
"title": "string",
"startTime": "string",
"endTime": "string",
"isAllDay": false,
"personName": "string"
}
],
"timing": {
"gapMinutes": 0,
"tightBelowMinutes": 0,
"suggestedDinnerTime": "string",
"latestStart": "string",
"activeMinutes": 0,
"totalMinutes": 0,
"nextEventTitle": "string",
"nextEventStart": "string",
"nextEventPersonName": "string"
},
"shopping": {
"planId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"shoppingListId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"itemsToBuy": 0,
"bestStoreName": "string",
"bestStoreHasEverything": false,
"estimatedTotal": 0,
"stale": false,
"itemsAtHome": 0
},
"questions": [
{
"id": "string",
"kind": {},
"requiresAdult": false
}
],
"notes": [
{
"id": "string",
"kind": {},
"answeredAt": "2026-09-07T16:30:00Z",
"undoable": false,
"undoExpiresAt": "2026-09-07T16:30:00Z"
}
]
}