Read meals
list_mealsRead-only
Read the person's saved meals, newest first. Filter by day, by fromDay and toDay (inclusive local dates) for a range such as a week, or by from and to timestamps, and optionally by state to see plans or eaten meals. Only meals in a result exist; never claim others do.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Only meals eaten before this time, with its UTC offset | |
| day | No | Only meals on this local date, in each meal's own timezone | |
| from | No | Only meals eaten at or after this time, with its UTC offset | |
| limit | No | The most meals to return | |
| state | No | Only planned meals or only eaten (logged) ones; leave out for both | |
| toDay | No | Only meals on or before this local date | |
| offset | No | Skip this many results. Pass the nextOffset of the previous page to read on; a null nextOffset means there are no more. | |
| fromDay | No | Only meals on or after this local date |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| meals | Yes | ||
| nextOffset | Yes |