Skip to content
Skip to Content
Docs
Studio

List Recipe Servings

List all active servings for a recipe.

Returns every serving defined on the recipe with its computed size, dual-column label status, and nutrition-facts availability flags. The top-level version_id mirrors the recipe's HEAD ULID on the main branch — clients can pass it back as If-Match on the next mutation for optimistic concurrency, or use it to pin a follow-up getRecipeServing call to the same snapshot. Accepts ?version_id= to read the servings list at a historical version.

Available only on API versions declaring the recipe_versioning capability. Requests without this capability receive a 404.

GET
/studio/recipes/{recipe_id}/servings

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 list servings endpoint.

data*array<>

All servings configured for this recipe.

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/servings'
Example Response
{  "data": [    {      "id": "string",      "serving_size_type": "string",      "serving_size": {        "household_measure": "string",        "metric_amount": 0,        "metric_unit": "string",        "servings_per_container": 0,        "serving_weight_g": 0      },      "racc_inputs": {        "category_id": "string",        "target_audience": "string",        "unit_type": "string",        "unit_weight_g": "string",        "declared_serving_units": 0,        "sold_individually": true,        "serving_weight_g": "string",        "household_unit_name": "string",        "household_unit_name_plural": "string"      },      "dual_column_status": "string",      "has_per_serving_nutrition_facts": true,      "has_per_container_nutrition_facts": true    }  ],  "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.