BETTERMENU
Studio

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. Older versions fall through to the legacy endpoint (no version_id stamping).

GET
/studio/recipes/{recipe_id}/servings/{serving_id}/nutrition-facts/analysis

Path Parameters

serving_id*Serving Id

Serving identifier

recipe_id*Recipe Id

Query Parameters

nutrient_set?|

Predefined nutrient group (e.g., fda_mandatory, macronutrients, vitamins_minerals)

bmids?|

Comma-separated BMIDs to filter

version_id?|

Optional version ULID to pin the response to a historical snapshot. Omit to read the live HEAD on the main branch. 26-character Crockford Base32 (no I, L, O, U).

Response Body

application/json

application/json

curl -X GET "https://loading/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
      }
    ],
    "nutrients": [
      {
        "bmid": "string",
        "name": "string",
        "unit": "string",
        "amount": 0,
        "contributions": [
          {
            "ingredient_index": 0,
            "amount": 0
          }
        ],
        "value_rounding": {
          "rule_name": "string",
          "original_value": 0,
          "rounded_value": 0,
          "display_text": "string"
        },
        "percent_daily_value": 0,
        "dv_rounding": {
          "rule_name": "string",
          "original_percent": 0,
          "rounded_percent": 0
        },
        "daily_value_reference": 0
      }
    ]
  },
  "meta": {
    "version": "string",
    "request_id": "string",
    "timestamp": "string"
  }
}
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}