Update Nutrition Record

curl --request PATCH \
  --url https://app-api.spikeapi.com/v3/nutrition_records/{nutrition_record_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "serving_size": 123
}
'

{
  "modified_at": "2023-11-07T05:31:56Z",
  "record_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "pending",
  "uploaded_at": "2023-11-07T05:31:56Z",
  "consumed_at": "2023-11-07T05:31:56Z",
  "dish_description": "<string>",
  "dish_description_translated": "<string>",
  "dish_name": "<string>",
  "dish_name_translated": "<string>",
  "failure_reason": "<string>",
  "ingredients": [
    {
      "name": "<string>",
      "serving_size": 123,
      "unit": "g",
      "name_translated": "<string>",
      "nutritional_fields": {
        "calcium_mg": 123,
        "carbohydrate_g": 123,
        "cholesterol_mg": 123,
        "energy_kcal": 123,
        "fat_monounsaturated_g": 123,
        "fat_polyunsaturated_g": 123,
        "fat_saturated_g": 123,
        "fat_total_g": 123,
        "fat_trans_g": 123,
        "fiber_total_dietary_g": 123,
        "folate_mcg": 123,
        "iron_mg": 123,
        "magnesium_mg": 123,
        "niacin_mg": 123,
        "phosphorus_mg": 123,
        "potassium_mg": 123,
        "protein_g": 123,
        "riboflavin_mg": 123,
        "sodium_mg": 123,
        "sugars_total_g": 123,
        "thiamin_mg": 123,
        "vitamin_a_rae_mcg": 123,
        "vitamin_b12_mcg": 123,
        "vitamin_b6_mg": 123,
        "vitamin_c_mg": 123,
        "vitamin_d_mcg": 123,
        "vitamin_e_mg": 123,
        "vitamin_k_mcg": 123,
        "zinc_mg": 123
      }
    }
  ],
  "nutri_score": "<string>",
  "nutritional_fields": {
    "calcium_mg": 123,
    "carbohydrate_g": 123,
    "cholesterol_mg": 123,
    "energy_kcal": 123,
    "fat_monounsaturated_g": 123,
    "fat_polyunsaturated_g": 123,
    "fat_saturated_g": 123,
    "fat_total_g": 123,
    "fat_trans_g": 123,
    "fiber_total_dietary_g": 123,
    "folate_mcg": 123,
    "iron_mg": 123,
    "magnesium_mg": 123,
    "niacin_mg": 123,
    "phosphorus_mg": 123,
    "potassium_mg": 123,
    "protein_g": 123,
    "riboflavin_mg": 123,
    "sodium_mg": 123,
    "sugars_total_g": 123,
    "thiamin_mg": 123,
    "vitamin_a_rae_mcg": 123,
    "vitamin_b12_mcg": 123,
    "vitamin_b6_mg": 123,
    "vitamin_c_mg": 123,
    "vitamin_d_mcg": 123,
    "vitamin_e_mg": 123,
    "vitamin_k_mcg": 123,
    "zinc_mg": 123
  },
  "serving_size": 123,
  "unit": "g"
}

Update Nutrition Record

Change the portion size for a nutrition record by ID.

You can update the total serving size of any analyzed nutrition record.

When the serving size is changed, all ingredients and their respective nutritional fields will be automatically recalculated proportionally to maintain the same nutritional ratios. This allows you to easily adjust portion sizes while maintaining accurate nutritional information.

The new serving size is expected to be in the same unit as the original serving size.

curl --request PATCH \
  --url https://app-api.spikeapi.com/v3/nutrition_records/{nutrition_record_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "serving_size": 123
}
'

{
  "modified_at": "2023-11-07T05:31:56Z",
  "record_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "pending",
  "uploaded_at": "2023-11-07T05:31:56Z",
  "consumed_at": "2023-11-07T05:31:56Z",
  "dish_description": "<string>",
  "dish_description_translated": "<string>",
  "dish_name": "<string>",
  "dish_name_translated": "<string>",
  "failure_reason": "<string>",
  "ingredients": [
    {
      "name": "<string>",
      "serving_size": 123,
      "unit": "g",
      "name_translated": "<string>",
      "nutritional_fields": {
        "calcium_mg": 123,
        "carbohydrate_g": 123,
        "cholesterol_mg": 123,
        "energy_kcal": 123,
        "fat_monounsaturated_g": 123,
        "fat_polyunsaturated_g": 123,
        "fat_saturated_g": 123,
        "fat_total_g": 123,
        "fat_trans_g": 123,
        "fiber_total_dietary_g": 123,
        "folate_mcg": 123,
        "iron_mg": 123,
        "magnesium_mg": 123,
        "niacin_mg": 123,
        "phosphorus_mg": 123,
        "potassium_mg": 123,
        "protein_g": 123,
        "riboflavin_mg": 123,
        "sodium_mg": 123,
        "sugars_total_g": 123,
        "thiamin_mg": 123,
        "vitamin_a_rae_mcg": 123,
        "vitamin_b12_mcg": 123,
        "vitamin_b6_mg": 123,
        "vitamin_c_mg": 123,
        "vitamin_d_mcg": 123,
        "vitamin_e_mg": 123,
        "vitamin_k_mcg": 123,
        "zinc_mg": 123
      }
    }
  ],
  "nutri_score": "<string>",
  "nutritional_fields": {
    "calcium_mg": 123,
    "carbohydrate_g": 123,
    "cholesterol_mg": 123,
    "energy_kcal": 123,
    "fat_monounsaturated_g": 123,
    "fat_polyunsaturated_g": 123,
    "fat_saturated_g": 123,
    "fat_total_g": 123,
    "fat_trans_g": 123,
    "fiber_total_dietary_g": 123,
    "folate_mcg": 123,
    "iron_mg": 123,
    "magnesium_mg": 123,
    "niacin_mg": 123,
    "phosphorus_mg": 123,
    "potassium_mg": 123,
    "protein_g": 123,
    "riboflavin_mg": 123,
    "sodium_mg": 123,
    "sugars_total_g": 123,
    "thiamin_mg": 123,
    "vitamin_a_rae_mcg": 123,
    "vitamin_b12_mcg": 123,
    "vitamin_b6_mg": 123,
    "vitamin_c_mg": 123,
    "vitamin_d_mcg": 123,
    "vitamin_e_mg": 123,
    "vitamin_k_mcg": 123,
    "zinc_mg": 123
  },
  "serving_size": 123,
  "unit": "g"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

nutrition_record_id

string

required

Nutrition report record ID

Body

application/json

serving_size

number<double>

required

Serving size in metric units

Example:

120

Response

modified_at

string<date-time>

required

Update timestamp in UTC

Example:

"2025-09-15T10:30:12.132Z"

record_id

string<uuid>

required

Report record ID

Example:

"6ba7b810-9dad-11d1-80b4-00c04fd430c8"

status

enum<string>

required

Processing status

Available options:

pending,

processing,

completed,

failed

Example:

"completed"

uploaded_at

string<date-time>

required

Upload timestamp in UTC

Example:

"2025-09-15T10:30:04.521Z"

consumed_at

string<date-time>

The UTC time when food was consumed

Example:

"2025-09-15T08:15:00Z"

dish_description

string

Detected dish description

Example:

"beef, ground, lean, cooked with broccoli, raw and rice, brown, cooked"

dish_description_translated

string

Dish description translated to target language

Example:

"Rindfleisch, Hackfleisch, mager, gekocht mit Brokkoli, roh und Reis, braun, gekocht"

dish_name

string

Detected dish name

Example:

"beef and broccoli stir-fry"

dish_name_translated

string

Dish name translated to target language

Example:

"Rindfleisch und Brokkoli Pfanne"

failure_reason

string

Reason for processing failure

Example:

"Unable to identify food items"

ingredients

object[] | null

List of detected ingredients with nutritional information

Show child attributes

nutri_score

string

Nutri-Score known as the 5-Colour Nutrition label (A-E)

Example:

"B"

nutritional_fields

object

Nutritional values per 100 g/ml

Show child attributes

serving_size

number<double>

Serving size in metric units

Example:

120

unit

enum<string>

Metric unit (g for solids, ml for liquids)

Available options:

g,

mg,

mcg,

ml,

kcal

Example:

"g"

Get Nutrition Record

Delete Nutrition Record

⌘I

Integrating with Nutrition AI API

API Reference: Nutrition Records

Update Nutrition Record

Change the portion size for a nutrition record by ID.

Authorizations

Path Parameters

Body

Response