noshera

Get Targets

Get the user's nutrition/weight/water targets AND their meal types, merged into one response { targets, meal_types }. Call this before logging anything — meal types are user-defined (not fixed breakfast/lunch/dinner), so you need a meal_type_id from here before you can assign one on a log entry.

Search Foods

Search the food database (public USDA/OFF catalog, the user's private foods, and restaurant items). Results are capped at 25 and rate-limited to a search bucket separate from the general API allowance (as low as 10/min on the standard tier) — economize: search once, then log with the returned ids/snapshots rather than re-searching per item.

Log Meal

Log one or more food entries for a day in a single batch (POST /logs). Supports quick entries (description + calories, no food lookup needed) AND real foods (entry_type + source_food_id/recipe_id/custom_meal_id + a nutrition snapshot from search_foods). Nutrition is snapshotted at log time and never recomputed later. log_date defaults to today in the user's local timezone (America/Chicago unless told otherwise) if omitted — pass an explicit log_date for yesterday's late-night eating. meal_type_i

Log Quick

Convenience wrapper for logging a single quick entry when you just know the calories ("Sushi AYCE, 1400 cal") — no food lookup needed. log_date defaults to today in the user's local timezone if omitted.

Log Activity

Log active-energy/steps for a day (upserts per user+date+source — logging twice for the same day and source replaces, it does not add). log_date defaults to today if omitted.

Log Weight

Log a body-weight entry for a day (upserts per user+date — logging twice for the same day replaces, it does not add). log_date defaults to today if omitted.

Log Water

Log water intake for a day, in milliliters. ADDITIVE — this inserts a new row on top of whatever was already logged that day (three calls of 500ml each add up to 1500ml), it does not overwrite. Response includes the day's new running total. log_date defaults to today if omitted.

Get Journal

Read logged meals/totals for a date range (and optionally weight/water/activity too). from/to are both optional YYYY-MM-DD dates; if omitted this defaults to the last 7 days ending today. Range is capped at 31 days.

Create Food

Create a private user food (never a public catalog entry — search_foods still shows it as source_type "user_food" afterward). All nutrition fields are per 100g.

Create Recipe

Create a recipe from raw ingredients (recipes CREATE a food — the app then computes total/per-portion macros from your ingredient snapshots and can be logged later as a recipe_portion entry). Each ingredient carries its own nutrition snapshot; the server never recomputes from live food rows.

Create Custom Meal

Create a custom meal that ASSEMBLES existing items into one plate (unlike a recipe, which creates a new food from raw ingredients). Each item carries its own nutrition snapshot; logging this meal later expands into one meal_logs row per component, tagged with a shared log_group_id.