--- title: "List Nutrition Records" method: GET path: "/nutrition_records" tags: ["Nutrition AI"] --- # List Nutrition Records `GET /nutrition_records` Retrieve a list of nutrition records by the time range. ## Query parameters - `from_timestamp` string, date-time, required — Start time of the query range in UTC, inclusive - `to_timestamp` string, date-time, required — End time of the query range in UTC, non-inclusive - `consumed` string — Filter by consumed status: 'true' for saved records with consumed_at, 'false' for analyze-only records, 'any' for both. Default: 'true' ## Response `200` OK - NutritionRecord[], nullable - `consumed_at` string, date-time — The UTC time when food was consumed. By default, it is set to the record update time - `dish_description` string — Detected dish description - `dish_description_translated` string — Dish description translated to target language - `dish_name` string, required — Detected dish name - `dish_name_translated` string — Dish name translated to target language - `failure_reason` string — Reason for processing failure - `ingredients` NutritionRecordIngredient[], nullable — List of detected ingredients with nutritional information - `name` string, required — Ingredient name using LANGUAL standard terminology - `name_translated` string — Ingredient name translated to target language - `nutritional_fields` object — Nutritional values in the given serving size - `calcium_mg` number — Calcium in milligrams - `carbohydrate_g` number — Carbohydrates in grams - `cholesterol_mg` number — Cholesterol in milligrams - `energy_kcal` number — Energy in kilocalories - `fat_monounsaturated_g` number — Monounsaturated Fat in grams - `fat_polyunsaturated_g` number — Polyunsaturated Fat in grams - `fat_saturated_g` number — Saturated Fat in grams - `fat_total_g` number — Total Fat in grams - `fat_trans_g` number — Trans Fat in grams - `fiber_total_dietary_g` number — Dietary Fiber in grams - `folate_mcg` number — Folate in micrograms - `iron_mg` number — Iron in milligrams - `magnesium_mg` number — Magnesium in milligrams - `manganese_mcg` number — Manganese in micrograms - `niacin_mg` number — Niacin in milligrams - `phosphorus_mg` number — Phosphorus in milligrams - `potassium_mg` number — Potassium in milligrams - `protein_g` number — Protein in grams - `riboflavin_mg` number — Riboflavin in milligrams - `salt_g` number — Salt in grams - `salt_mg` number — Salt in milligrams - `sodium_g` number — Sodium in grams - `sodium_mg` number — Sodium in milligrams - `sugars_total_g` number — Total Sugars in grams - `thiamin_mg` number — Thiamin in milligrams - `vitamin_a_rae_mcg` number — Vitamin A in micrograms - `vitamin_b12_mcg` number — Vitamin B12 in micrograms - `vitamin_b6_mg` number — Vitamin B6 in milligrams - `vitamin_c_mg` number — Vitamin C in milligrams - `vitamin_d_mcg` number — Vitamin D in micrograms - `vitamin_e_mg` number — Vitamin E in milligrams - `vitamin_k_mcg` number — Vitamin K in micrograms - `zinc_mg` number — Zinc in milligrams - `serving_size` number, double, required — Serving size in metric units - `unit` 'g' | 'mg' | 'mcg' | 'ml' | 'kcal', required — Metric unit (g for solids, ml for liquids) - `input_type` 'image' | 'manual' | 'push' | 'text' — Nutrition record input type - `modified_at` string, date-time — Update timestamp in UTC - `nutri_score` string — Nutri-Score known as the 5-Colour Nutrition label (A-E) - `nutritional_fields` object — Nutritional values in the given serving size - `calcium_mg` number — Calcium in milligrams - `carbohydrate_g` number — Carbohydrates in grams - `cholesterol_mg` number — Cholesterol in milligrams - `energy_kcal` number — Energy in kilocalories - `fat_monounsaturated_g` number — Monounsaturated Fat in grams - `fat_polyunsaturated_g` number — Polyunsaturated Fat in grams - `fat_saturated_g` number — Saturated Fat in grams - `fat_total_g` number — Total Fat in grams - `fat_trans_g` number — Trans Fat in grams - `fiber_total_dietary_g` number — Dietary Fiber in grams - `folate_mcg` number — Folate in micrograms - `iron_mg` number — Iron in milligrams - `magnesium_mg` number — Magnesium in milligrams - `manganese_mcg` number — Manganese in micrograms - `niacin_mg` number — Niacin in milligrams - `phosphorus_mg` number — Phosphorus in milligrams - `potassium_mg` number — Potassium in milligrams - `protein_g` number — Protein in grams - `riboflavin_mg` number — Riboflavin in milligrams - `salt_g` number — Salt in grams - `salt_mg` number — Salt in milligrams - `sodium_g` number — Sodium in grams - `sodium_mg` number — Sodium in milligrams - `sugars_total_g` number — Total Sugars in grams - `thiamin_mg` number — Thiamin in milligrams - `vitamin_a_rae_mcg` number — Vitamin A in micrograms - `vitamin_b12_mcg` number — Vitamin B12 in micrograms - `vitamin_b6_mg` number — Vitamin B6 in milligrams - `vitamin_c_mg` number — Vitamin C in milligrams - `vitamin_d_mcg` number — Vitamin D in micrograms - `vitamin_e_mg` number — Vitamin E in milligrams - `vitamin_k_mcg` number — Vitamin K in micrograms - `zinc_mg` number — Zinc in milligrams - `record_id` string, uuid — Report record ID - `serving_size` number, double, required — Serving size in metric units - `status` 'pending' | 'processing' | 'completed' | 'failed' | 'updated' — Processing status - `unit` 'g' | 'mg' | 'mcg' | 'ml' | 'kcal', required — Metric unit (g for solids, ml for liquids) - `uploaded_at` string, date-time — Upload timestamp in UTC - `user_time_offset_minutes` integer — User's local timezone offset in minutes ## Other responses - `400` — Bad Request - `401` — Unauthorized - `404` — Not Found - `422` — Unprocessable Entity - `500` — Internal Server Error --- [API](https://skmtc.dev/spikeapi/apis/application-user-api.md) · [All operations](https://skmtc.dev/spikeapi/apis/application-user-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/spikeapi/application-user-api/revisions/637338fb0c9d/schema)