Skip to content
Skip to Content
Docs
Studio

Get Recipe Nutrition

Return total recipe nutrition (batch-level, all ingredients summed) — not per-serving.

reference_weight_grams is the total weight of all ingredients combined; no per-serving amounts or %DV are included. Pass ?version_id= to read nutrition at a historical snapshot. Returns 404 if nutrition has not been computed yet; use computeRecipeNutrition to trigger a manual recompute.

GET
/studio/recipes/{recipe_id}/nutrition

Path Parameters

recipe_id*Recipe Id

Query Parameters

version_id?|

Leave out for the current recipe. To read an earlier version, pass a version_id from the recipe's version list.

Response Body

Successful Response

application/json
  1. response

Response for get recipe nutrition endpoint.

data*

Batch-level nutrition for a recipe (sum of all ingredients, not per-serving).

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.

Example Request
curl -X GET 'https://api.bettermenu.live/studio/recipes/string/nutrition'
Example Response
{  "data": {    "calculated_at": "string",    "nutrients": [      {        "id": 1,        "bmid": "string",        "name": "string",        "total_amount": 0,        "unit": "string"      }    ],    "reference_weight_grams": 0  },  "meta": {    "version": "string",    "request_id": "string",    "timestamp": "string"  },  "version_id": "string"}

Recipe in, FDA-format Nutrition Facts out, with every version kept.

Start freeNo card needed.