Get Serving Nutrition Facts Analysis
Serving nutrition facts analysis with ingredient contributions and rounding audit trail.
Returns ingredient contributions (scaled to this serving's weight) alongside
full ValueRoundingOutcome and DVRoundingOutcome for each nutrient.
Supports filtering by nutrient_set and/or comma-separated BMIDs.
Accepts ?version_id= to read analysis at a specific version snapshot.
Available only on API versions declaring the recipe_versioning capability.
Requests without this capability receive a 404.
serving_id*Serving IdServing identifier
recipe_id*Recipe Idnutrient_set?|Predefined nutrient group (e.g., fda_mandatory, macronutrients, vitamins_minerals)
bmids?|Comma-separated BMIDs to filter
version_id?|Leave out for the current recipe. To read an earlier version, pass a version_id from the recipe's version list.
Successful Response
application/json- response
Response for nutrition facts analysis endpoint.
data*Per-serving nutrition facts analysis with rounding audit trail.
meta*Response metadata.
version_id?|Version committed for this mutation; pass on the next request as If-Match for optimistic concurrency. Present only on versions declaring the recipe_versioning capability.
curl -X GET 'https://api.bettermenu.live/studio/recipes/string/servings/string/nutrition-facts/analysis'{ "data": { "calculated_at": "string", "serving_id": "string", "demographic": "string", "reference_weight_grams": 0, "scale_factor": "string", "ingredients": [ { "name": "string", "quantity_g": 0, "original_text": "string", "kind": "standard", "custom_ingredient_id": "string" } ], "nutrients": [ { "bmid": "string", "name": "string", "unit": "string", "amount": 0, "contributions": [ { "ingredient_index": 0, "amount": 0, "share_percent": 0 } ], "value_rounding": { "rule_name": "string", "original_value": 0, "rounded_value": 0, "display_text": "string", "action": "string", "increment": "string" }, "percent_daily_value": 0, "dv_rounding": { "rule_name": "string", "original_percent": 0, "rounded_percent": 0, "action": "string", "increment": "string" }, "daily_value_reference": 0 } ] }, "meta": { "version": "string", "request_id": "string", "timestamp": "string" }, "version_id": "string"}