Get Nutrition Label
Get a render-ready nutrition label for one serving, optionally pinned to a version.
Assembles header, regulatory-ordered nutrient columns (per-serving and optional per-container), footnotes, staleness, and completeness into a single response ready for label rendering.
Accepts ?version_id= to read the label 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 Idversion_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
GET nutrition-label response envelope.
data*Complete render-ready nutrition label.
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-label'{ "data": { "header": { "serving_size_household": "string", "serving_size_metric": "string", "servings_per_container": "string", "demographic": "string" }, "per_serving": { "reference_weight_grams": "string", "nutrients": [ { "bmid": "string", "display_name": "string", "amount": "string", "unit": "string", "display_text": "string", "percent_dv": "string", "is_mandatory": true, "is_visible": true, "basis": "reported", "children": [ {} ] } ] }, "per_container": { "reference_weight_grams": "string", "nutrients": [ { "bmid": "string", "display_name": "string", "amount": "string", "unit": "string", "display_text": "string", "percent_dv": "string", "is_mandatory": true, "is_visible": true, "basis": "reported", "children": [ {} ] } ] }, "footnotes": [ "string" ], "staleness": { "is_current": true, "calculated_at": "string" }, "completeness": { "is_complete": true, "missing_mandatory": [ { "bmid": "string", "display_name": "string" } ] }, "readiness": { "profile": { "jurisdiction": "string", "format": "standard_vertical", "ruleset": "string" }, "status": "ready", "ruleset_version": "string", "bundle_version": "string", "source": "stored", "fills_hash": "string", "findings": [ { "code": "string", "severity": "blocking", "area": "declaration", "review": true, "nutrient": "string", "cause": "no_source_value", "cite": "string", "message": "string" } ], "needs_review": true }, "added_sugars": { "state": "no_report", "is_finding": true, "message": "string", "report_hash": "string", "total_rows": 0, "answered_rows": 0, "open_rows": 0, "suggested_not_accepted_rows": 0, "confirmed_at": "2019-08-24T14:15:22Z" }, "findings": [ { "code": "added_sugars_not_confirmed", "nutrients": [ { "bmid": "string", "display_name": "string" } ], "message": "string" } ], "findings_hash": "string" }, "meta": { "version": "string", "request_id": "string", "timestamp": "string" }, "version_id": "string"}