šŸ”“ Get dish recommendation for an APIUser. ā±ā­

Ā© Consumes your monthly credits. Limited amount of monthly calls, exceeding calls will be charged as extras.

(S) Limited amount of calls per second.

Ā 

Returns LogMeal dish IDs personalized for the authenticated APIUser.

Candidate dishes are first generated using the existing food-group and Variety Score logic. The candidates are then personalized using the user's configured food restrictions and preferences, remaining daily nutritional targets, active nutritional plan, and recently consumed dishes.

High-confidence conflicts with configured hard restrictions can exclude a dish. The other available signals re-rank the remaining candidates. If a personalization signal cannot be resolved for a candidate or user, the remaining available signals continue to be used; the food-group/Variety Score candidate-generation stage remains the baseline.

When no custom nutritional goal exists for a tracked nutrient, the recommendation logic can use the user's calculated recommended daily intake as the target.

The endpoint returns up to 8 dish IDs. The final selection includes controlled randomization among the highest-ranked candidates, so clients should not rely on the exact order being deterministic between equivalent calls.

Use GET /v2/dataset/dishes to retrieve information about the returned dish IDs.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string
enum
Defaults to nutri_score

Optional score used by the existing Variety Score / food-group candidate-generation stage.
Currently the only accepted value is nutri_score. When omitted, nutri_score is used.

Allowed:
date

Start date of the intake-history period considered by the recommendation logic, in YYYY-MM-DD format.
When omitted, the API uses a 7-day lookback ending at the current time in the APIUser's timezone.

string

Optional meal occasion. Default occasions include breakfast, lunch, dinner, and snack.
When omitted, the recommendation can use all available food groups.

string

Optional bracketed list of food-group IDs to use during Variety Score candidate generation, for example [6, 4].
When omitted, food groups are selected from the occasion; if no occasion is provided, all default recommendation food groups are considered.
Available food groups can be retrieved through GET /v2/dataset/foodgroups.

Responses

401

Unauthorized, invalid token

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json